-
Notifications
You must be signed in to change notification settings - Fork 312
Commit
* Add documentation for packages - 2023-12-08 * remove google, databricks, odbc, docker providers from rc1
- Loading branch information
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
# Sphinx build info version 1 | ||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. | ||
config: 4f2197818df059c3f8192a54a4dcc2a2 | ||
tags: 645f666f9bcd5a90fca523b33c5a78b7 |
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Large diffs are not rendered by default.
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,122 @@ | ||
:py:mod:`airflow.providers.airbyte.hooks.airbyte` | ||
================================================= | ||
|
||
.. py:module:: airflow.providers.airbyte.hooks.airbyte | ||
Module Contents | ||
--------------- | ||
|
||
Classes | ||
~~~~~~~ | ||
|
||
.. autoapisummary:: | ||
|
||
airflow.providers.airbyte.hooks.airbyte.AirbyteHook | ||
|
||
|
||
|
||
|
||
.. py:class:: AirbyteHook(airbyte_conn_id = 'airbyte_default', api_version = 'v1') | ||
Bases: :py:obj:`airflow.providers.http.hooks.http.HttpHook` | ||
|
||
Hook for Airbyte API. | ||
|
||
:param airbyte_conn_id: Optional. The name of the Airflow connection to get | ||
connection information for Airbyte. Defaults to "airbyte_default". | ||
:param api_version: Optional. Airbyte API version. Defaults to "v1". | ||
|
||
.. py:attribute:: conn_name_attr | ||
:value: 'airbyte_conn_id' | ||
|
||
|
||
|
||
.. py:attribute:: default_conn_name | ||
:value: 'airbyte_default' | ||
|
||
|
||
|
||
.. py:attribute:: conn_type | ||
:value: 'airbyte' | ||
|
||
|
||
|
||
.. py:attribute:: hook_name | ||
:value: 'Airbyte' | ||
|
||
|
||
|
||
.. py:attribute:: RUNNING | ||
:value: 'running' | ||
|
||
|
||
|
||
.. py:attribute:: SUCCEEDED | ||
:value: 'succeeded' | ||
|
||
|
||
|
||
.. py:attribute:: CANCELLED | ||
:value: 'cancelled' | ||
|
||
|
||
|
||
.. py:attribute:: PENDING | ||
:value: 'pending' | ||
|
||
|
||
|
||
.. py:attribute:: FAILED | ||
:value: 'failed' | ||
|
||
|
||
|
||
.. py:attribute:: ERROR | ||
:value: 'error' | ||
|
||
|
||
|
||
.. py:attribute:: INCOMPLETE | ||
:value: 'incomplete' | ||
|
||
|
||
|
||
.. py:method:: wait_for_job(job_id, wait_seconds = 3, timeout = 3600) | ||
Poll a job to check if it finishes. | ||
|
||
:param job_id: Required. Id of the Airbyte job | ||
:param wait_seconds: Optional. Number of seconds between checks. | ||
:param timeout: Optional. How many seconds wait for job to be ready. | ||
Used only if ``asynchronous`` is False. | ||
|
||
|
||
.. py:method:: submit_sync_connection(connection_id) | ||
Submit a job to a Airbyte server. | ||
|
||
:param connection_id: Required. The ConnectionId of the Airbyte Connection. | ||
|
||
|
||
.. py:method:: get_job(job_id) | ||
Get the resource representation for a job in Airbyte. | ||
|
||
:param job_id: Required. Id of the Airbyte job | ||
|
||
|
||
.. py:method:: cancel_job(job_id) | ||
Cancel the job when task is cancelled. | ||
|
||
:param job_id: Required. Id of the Airbyte job | ||
|
||
|
||
.. py:method:: test_connection() | ||
Tests the Airbyte connection by hitting the health API. | ||
|
||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
:py:mod:`airflow.providers.airbyte.hooks` | ||
========================================= | ||
|
||
.. py:module:: airflow.providers.airbyte.hooks | ||
Submodules | ||
---------- | ||
.. toctree:: | ||
:titlesonly: | ||
:maxdepth: 1 | ||
|
||
airbyte/index.rst | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
:py:mod:`airflow.providers.airbyte` | ||
=================================== | ||
|
||
.. py:module:: airflow.providers.airbyte | ||
Subpackages | ||
----------- | ||
.. toctree:: | ||
:titlesonly: | ||
:maxdepth: 3 | ||
|
||
hooks/index.rst | ||
operators/index.rst | ||
sensors/index.rst | ||
|
||
|
||
Package Contents | ||
---------------- | ||
|
||
.. py:data:: __version__ | ||
:value: '3.5.0' | ||
|
||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
:py:mod:`airflow.providers.airbyte.operators.airbyte` | ||
===================================================== | ||
|
||
.. py:module:: airflow.providers.airbyte.operators.airbyte | ||
Module Contents | ||
--------------- | ||
|
||
Classes | ||
~~~~~~~ | ||
|
||
.. autoapisummary:: | ||
|
||
airflow.providers.airbyte.operators.airbyte.AirbyteTriggerSyncOperator | ||
|
||
|
||
|
||
|
||
.. py:class:: AirbyteTriggerSyncOperator(connection_id, airbyte_conn_id = 'airbyte_default', asynchronous = False, api_version = 'v1', wait_seconds = 3, timeout = 3600, **kwargs) | ||
Bases: :py:obj:`airflow.models.BaseOperator` | ||
|
||
Submits a job to an Airbyte server to run a integration process between your source and destination. | ||
|
||
.. seealso:: | ||
For more information on how to use this operator, take a look at the guide: | ||
:ref:`howto/operator:AirbyteTriggerSyncOperator` | ||
|
||
:param airbyte_conn_id: Optional. The name of the Airflow connection to get connection | ||
information for Airbyte. Defaults to "airbyte_default". | ||
:param connection_id: Required. The Airbyte ConnectionId UUID between a source and destination. | ||
:param asynchronous: Optional. Flag to get job_id after submitting the job to the Airbyte API. | ||
This is useful for submitting long running jobs and | ||
waiting on them asynchronously using the AirbyteJobSensor. Defaults to False. | ||
:param api_version: Optional. Airbyte API version. Defaults to "v1". | ||
:param wait_seconds: Optional. Number of seconds between checks. Only used when ``asynchronous`` is False. | ||
Defaults to 3 seconds. | ||
:param timeout: Optional. The amount of time, in seconds, to wait for the request to complete. | ||
Only used when ``asynchronous`` is False. Defaults to 3600 seconds (or 1 hour). | ||
|
||
.. py:attribute:: template_fields | ||
:type: Sequence[str] | ||
:value: ('connection_id',) | ||
|
||
|
||
|
||
.. py:method:: execute(context) | ||
Create Airbyte Job and wait to finish. | ||
|
||
|
||
.. py:method:: on_kill() | ||
Cancel the job if task is cancelled. | ||
|
||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
:py:mod:`airflow.providers.airbyte.operators` | ||
============================================= | ||
|
||
.. py:module:: airflow.providers.airbyte.operators | ||
Submodules | ||
---------- | ||
.. toctree:: | ||
:titlesonly: | ||
:maxdepth: 1 | ||
|
||
airbyte/index.rst | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
:py:mod:`airflow.providers.airbyte.sensors.airbyte` | ||
=================================================== | ||
|
||
.. py:module:: airflow.providers.airbyte.sensors.airbyte | ||
.. autoapi-nested-parse:: | ||
|
||
This module contains a Airbyte Job sensor. | ||
|
||
|
||
|
||
Module Contents | ||
--------------- | ||
|
||
Classes | ||
~~~~~~~ | ||
|
||
.. autoapisummary:: | ||
|
||
airflow.providers.airbyte.sensors.airbyte.AirbyteJobSensor | ||
|
||
|
||
|
||
|
||
.. py:class:: AirbyteJobSensor(*, airbyte_job_id, airbyte_conn_id = 'airbyte_default', api_version = 'v1', **kwargs) | ||
Bases: :py:obj:`airflow.sensors.base.BaseSensorOperator` | ||
|
||
Check for the state of a previously submitted Airbyte job. | ||
|
||
:param airbyte_job_id: Required. Id of the Airbyte job | ||
:param airbyte_conn_id: Optional. The name of the Airflow connection to get | ||
connection information for Airbyte. Defaults to "airbyte_default". | ||
:param api_version: Optional. Airbyte API version. Defaults to "v1". | ||
|
||
.. py:attribute:: template_fields | ||
:type: Sequence[str] | ||
:value: ('airbyte_job_id',) | ||
|
||
|
||
|
||
.. py:attribute:: ui_color | ||
:value: '#6C51FD' | ||
|
||
|
||
|
||
.. py:method:: poke(context) | ||
Override when deriving this class. | ||
|
||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
:py:mod:`airflow.providers.airbyte.sensors` | ||
=========================================== | ||
|
||
.. py:module:: airflow.providers.airbyte.sensors | ||
Submodules | ||
---------- | ||
.. toctree:: | ||
:titlesonly: | ||
:maxdepth: 1 | ||
|
||
airbyte/index.rst | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
:py:mod:`tests.system.providers.airbyte.example_airbyte_trigger_job` | ||
==================================================================== | ||
|
||
.. py:module:: tests.system.providers.airbyte.example_airbyte_trigger_job | ||
.. autoapi-nested-parse:: | ||
|
||
Example DAG demonstrating the usage of the AirbyteTriggerSyncOperator. | ||
|
||
|
||
|
||
Module Contents | ||
--------------- | ||
|
||
.. py:data:: ENV_ID | ||
.. py:data:: DAG_ID | ||
:value: 'example_airbyte_operator' | ||
|
||
|
||
|
||
.. py:data:: CONN_ID | ||
:value: '15bc3800-82e4-48c3-a32d-620661273f28' | ||
|
||
|
||
|
||
.. py:data:: sync_source_destination | ||
.. py:data:: test_run | ||
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
:py:mod:`tests.system.providers.airbyte` | ||
======================================== | ||
|
||
.. py:module:: tests.system.providers.airbyte | ||
Submodules | ||
---------- | ||
.. toctree:: | ||
:titlesonly: | ||
:maxdepth: 1 | ||
|
||
example_airbyte_trigger_job/index.rst | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
|
||
.. Licensed to the Apache Software Foundation (ASF) under one | ||
or more contributor license agreements. See the NOTICE file | ||
distributed with this work for additional information | ||
regarding copyright ownership. The ASF licenses this file | ||
to you under the Apache License, Version 2.0 (the | ||
"License"); you may not use this file except in compliance | ||
with the License. You may obtain a copy of the License at | ||
.. http://www.apache.org/licenses/LICENSE-2.0 | ||
.. Unless required by applicable law or agreed to in writing, | ||
software distributed under the License is distributed on an | ||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | ||
KIND, either express or implied. See the License for the | ||
specific language governing permissions and limitations | ||
under the License. | ||
.. NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE | ||
OVERWRITTEN WHEN PREPARING PACKAGES. | ||
.. IF YOU WANT TO MODIFY THIS FILE, YOU SHOULD MODIFY THE TEMPLATE | ||
`PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2` IN the `dev/breeze/src/airflow_breeze/templates` DIRECTORY | ||
.. include:: ../../airflow/providers/airbyte/CHANGELOG.rst |