Skip to content

Commit

Permalink
docs: Platform Wording Updates (#38070)
Browse files Browse the repository at this point in the history
  • Loading branch information
nataliekwong committed May 8, 2024
1 parent 82e28bf commit 8e4cecf
Show file tree
Hide file tree
Showing 4 changed files with 16 additions and 32 deletions.
2 changes: 1 addition & 1 deletion docs/access-management/sso-providers/okta.md
Expand Up @@ -70,7 +70,7 @@ On the following screen you'll need to configure all parameters for your Okta ap

<dl>
<dt>**App integration name**</dt>
<dd>Please choose a URL-friendly app integraiton name without spaces or special characters, such as `my-airbyte-app`. Screenshot of Okta app integration name Spaces or special characters in this field could result in invalid redirect URIs.</dd>
<dd>Please choose a URL-friendly app integration name without spaces or special characters, such as `my-airbyte-app`. Screenshot of Okta app integration name Spaces or special characters in this field could result in invalid redirect URIs.</dd>
<dt>**Logo** (optional)</dt>
<dd>You can upload an Airbyte logo, which you can find at https://airbyte.com/company/press</dd>
<dt>**Grant type**</dt>
Expand Down
38 changes: 11 additions & 27 deletions docs/cloud/managing-airbyte-cloud/dbt-cloud-integration.md
Expand Up @@ -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.

:::

## 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

## 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 2: Set up the dbt Cloud integration in Airbyte Cloud

To set up the dbt Cloud integration in Airbyte Cloud:

1. In the Airbyte UI, click **Settings**.

2. Click **Integrations**.

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.
## Step 1: Generate a service token

5. Go to the **Transformation** tab and click **+ Add transformation**.
Generate a [service token](https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens#generate-service-account-tokens) to enable authentication with dbt Cloud.

6. Select the transformation from the dropdown and click **Save changes**. The transformation will run during the subsequent syncs until you remove it.
## Step 2: Set up the dbt Cloud integration in Airbyte Cloud

:::note
1. Click **Settings** and then **Integrations**. Enter your service token and click **Save changes**.

You can have multiple transformations per connection.
2. Click **Connections** and select the connection you want to add a dbt transformation to. Go to the **Transformation** tab and click **+ Add transformation**.

:::
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.

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**.
4 changes: 2 additions & 2 deletions docs/cloud/managing-airbyte-cloud/manage-connection-state.md
Expand Up @@ -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.
4 changes: 2 additions & 2 deletions docs/cloud/managing-airbyte-cloud/review-connection-status.md
Expand Up @@ -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.
Expand All @@ -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.

0 comments on commit 8e4cecf

Please sign in to comment.