docs: Platform Wording Updates (#38070)
This commit is contained in:
@@ -4,45 +4,29 @@ products: cloud
|
||||
|
||||
# Use the dbt Cloud integration
|
||||
|
||||
By using the dbt Cloud integration, you can create and run dbt transformations during syncs in Airbyte Cloud. This allows you to transform raw data into a format that is suitable for analysis and reporting, including cleaning and enriching the data.
|
||||
By using the dbt Cloud integration, you can create and run dbt transformations immediately following syncs in Airbyte Cloud. This allows you to transform raw data into a format that is suitable for analysis and reporting, including cleaning and enriching the data.
|
||||
|
||||
:::note
|
||||
|
||||
Normalizing data may cause an increase in your destination's compute cost. This cost will vary depending on the amount of data that is normalized and is not related to Airbyte credit usage.
|
||||
Transforming data may cause an increase in your destination's compute cost. This cost will vary depending on the amount of data that is transformed and is not related to Airbyte credit usage.
|
||||
|
||||
:::
|
||||
|
||||
## Prerequisites
|
||||
- To use the dbt Cloud integration, you must use a paid version of dbt Cloud.
|
||||
- The service token must have Member, Job Admin, or Account Admin permissions.
|
||||
- Airbyte currently only supports integration with dbt Cloud accounts that have an access URL beginning with `https://cloud.getdbt.com/`. [Custom access URLs](https://docs.getdbt.com/docs/cloud/about-cloud/access-regions-ip-addresses#accessing-your-account) are not supported at this time.
|
||||
|
||||
## Step 1: Generate a service token
|
||||
|
||||
Generate a [service token](https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens#generating-service-account-tokens) for your dbt Cloud transformation.
|
||||
|
||||
:::note
|
||||
|
||||
- To use the dbt Cloud integration, you must use a paid version of dbt Cloud.
|
||||
- The service token must have Member, Job Admin, or Account Admin permissions.
|
||||
|
||||
:::
|
||||
Generate a [service token](https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens#generate-service-account-tokens) to enable authentication with dbt Cloud.
|
||||
|
||||
## Step 2: Set up the dbt Cloud integration in Airbyte Cloud
|
||||
|
||||
To set up the dbt Cloud integration in Airbyte Cloud:
|
||||
1. Click **Settings** and then **Integrations**. Enter your service token and click **Save changes**.
|
||||
|
||||
1. In the Airbyte UI, click **Settings**.
|
||||
2. Click **Connections** and select the connection you want to add a dbt transformation to. Go to the **Transformation** tab and click **+ Add transformation**.
|
||||
|
||||
2. Click **Integrations**.
|
||||
3. Select the transformation from the dropdown and click **Save changes**. The transformation will run after the subsequent syncs until you remove it. You can repeat these steps to add additional transformations for a connection.
|
||||
|
||||
3. Paste the service token from [Step 1](#step-1-generate-a-service-token) and click **Save changes**.
|
||||
|
||||
4. Click **Connections** and select the connection you want to add a dbt transformation to.
|
||||
|
||||
5. Go to the **Transformation** tab and click **+ Add transformation**.
|
||||
|
||||
6. Select the transformation from the dropdown and click **Save changes**. The transformation will run during the subsequent syncs until you remove it.
|
||||
|
||||
:::note
|
||||
|
||||
You can have multiple transformations per connection.
|
||||
|
||||
:::
|
||||
|
||||
8. To remove a transformation, click **X** on the transformation and click **Save changes**.
|
||||
4. To remove a transformation, click **X** on the transformation and click **Save changes**.
|
||||
|
||||
@@ -19,11 +19,11 @@ To review the connection state:
|
||||
Editing the connection state allows the sync to start from any date in the past. If the state is edited, Airbyte will start syncing incrementally from the new date. This is helpful if you do not want to fully resync your data. To edit the connection state:
|
||||
|
||||
:::warning
|
||||
Updates to connection state should be handled with extreme care. Updates may break your syncs, requiring a reset to fix. Make changes only as directed by the Airbyte team.
|
||||
Updates to connection state should be handled with extreme care. Updates may break your syncs, requiring a full historical sync of your data to fix. Make changes only as directed by the Airbyte team.
|
||||
:::
|
||||
|
||||
1. Click anywhere in the Connection state to start editing.
|
||||
|
||||
2. Confirm changes by clicking "Update state". Discard any changes by clikcing "Revert changes".
|
||||
2. Confirm changes by clicking "Update state". Discard any changes by clicking "Revert changes".
|
||||
|
||||
3. Confirm the changes to the connection state update.
|
||||
|
||||
@@ -28,7 +28,7 @@ To review the connection status:
|
||||
If the most recent sync failed, you'll see the error message that will help diagnose if the failure is due to a source or destination configuration error. [Reach out](/community/getting-support.md) to us if you need any help to ensure you data continues syncing.
|
||||
|
||||
:::info
|
||||
If a sync starts to fail, it will automatically be disabled after 100 consecutive failures or 14 consecutive days of failure.
|
||||
If a sync starts to fail, it will automatically be disabled after multiple consecutive failures or several consecutive days of failure.
|
||||
:::
|
||||
|
||||
If a new major version of the connector has been released, you will also see a banner on this page indicating the cutoff date for the version. Airbyte recommends upgrading before the cutoff date to ensure your data continues syncing. If you do not upgrade before the cutoff date, Airbyte will automatically disable your connection.
|
||||
@@ -47,6 +47,6 @@ The stream status allows you to monitor each stream's latest status. The stream
|
||||
|
||||
Each stream shows the last record loaded to the destination. Toggle the header to display the exact datetime the last record was loaded.
|
||||
|
||||
You can [reset](/operator-guides/reset.md) an individual stream without resetting all streams in a connection by clicking the three grey dots next to any stream.
|
||||
You can [clear](/operator-guides/reset.md) an individual stream without clearing all streams in a connection by clicking the three grey dots next to any stream.
|
||||
|
||||
You can also navigate directly to the stream's configuration by click the three grey dots next to any stream and selecting "Open details" to be redirected to the stream configuration.
|
||||
|
||||
Reference in New Issue
Block a user