From d2dadb1cb2eedabdf6e2bf0ccb9e38b552f377f8 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 15 Jun 2023 14:32:18 +0100 Subject: [PATCH 01/12] clarify setup page content/headers as part of references, changing setup pages and clarifying content so its more understandable and scalable. --- .../docs/core/connect-data-platform/bigquery-setup.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 8df69d2f7e3..7ebec8916ae 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -15,7 +15,6 @@ meta: config_page: '/reference/resource-configs/bigquery-configs' --- -

Overview of {frontMatter.meta.pypi_package}

@@ -31,21 +30,18 @@ meta:
  • Minimum data platform version: {frontMatter.meta.min_supported_version}
  • -

    Installing {frontMatter.meta.pypi_package}

    +

    Installing {frontMatter.meta.pypi_package}

    -pip is the easiest way to install the adapter: +Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: pip install {frontMatter.meta.pypi_package} -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    -

    Configuring {frontMatter.meta.pypi_package}

    -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    +

    To optimize performance and for {frontMatter.meta.platform_name}-specific configuration please refer to {frontMatter.meta.platform_name} configs

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    - ## Authentication Methods BigQuery targets can be specified using one of four methods: From c5dc689f83146112bb05cb629fa9c9f4f0b03dd9 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 15 Jun 2023 14:34:37 +0100 Subject: [PATCH 02/12] add snippet --- .../core/connect-data-platform/bigquery-setup.md | 12 +----------- website/snippets/setup-pages-intro.md | 11 +++++++++++ 2 files changed, 12 insertions(+), 11 deletions(-) create mode 100644 website/snippets/setup-pages-intro.md diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 7ebec8916ae..57afc24dec6 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -30,17 +30,7 @@ meta:
  • Minimum data platform version: {frontMatter.meta.min_supported_version}
  • -

    Installing {frontMatter.meta.pypi_package}

    - -Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: - -pip install {frontMatter.meta.pypi_package} - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    To optimize performance and for {frontMatter.meta.platform_name}-specific configuration please refer to {frontMatter.meta.platform_name} configs

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Authentication Methods diff --git a/website/snippets/setup-pages-intro.md b/website/snippets/setup-pages-intro.md new file mode 100644 index 00000000000..bae87933f1d --- /dev/null +++ b/website/snippets/setup-pages-intro.md @@ -0,0 +1,11 @@ +

    Installing {frontMatter.meta.pypi_package}

    + +Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: + +pip install {frontMatter.meta.pypi_package} + +

    Configuring {frontMatter.meta.pypi_package}

    + +

    To optimize performance and for {frontMatter.meta.platform_name}-specific configuration please refer to {frontMatter.meta.platform_name} configs

    + +

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    From 858dfddcfc73f531ab084bde3c2c9f64ac1116cc Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 15 Jun 2023 20:05:45 +0100 Subject: [PATCH 03/12] adding partial --- .../connect-data-platform/bigquery-setup.md | 49 +++++++++---------- website/snippets/_setup-pages-intro.md | 23 +++++++++ website/snippets/setup-pages-intro.md | 11 ----- 3 files changed, 46 insertions(+), 37 deletions(-) create mode 100644 website/snippets/_setup-pages-intro.md delete mode 100644 website/snippets/setup-pages-intro.md diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 57afc24dec6..af4a5ea886f 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -17,31 +17,36 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    +## Test -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    +import SetUpPages from '/snippets/_setup-pages-intro.md'; - + -## Authentication Methods +## Prerequisites -BigQuery targets can be specified using one of four methods: +You need to have the required [BigQuery permissions](https://cloud.google.com/bigquery/docs/access-control) to create adapter-specific configurations in your dbt project. BigQuery's permission model is dissimilar from more conventional databases like Snowflake and Redshift. The following permissions are required for dbt user accounts: -1. [oauth via `gcloud`](#oauth-via-gcloud) -2. [oauth token-based](#oauth-token-based) -3. [service account file](#service-account-file) -4. [service account json](#service-account-json) + - BigQuery Data Editor + - BigQuery User +This set of permissions will permit dbt users to read from and create tables and views in a BigQuery project. +## Authentication methods + +You can specify BigQuery targets using one of four methods: + +| Auth method | Description | Supported | +| ----------- | ----------- | --------- | +| OAuth via gcloud | Recommended for local development + +1. [Oauth via `gcloud`](#oauth-via-gcloud) +2. [Oauth token-based](#oauth-token-based) +3. [Service account file](#service-account-file) +4. [Service account json](#service-account-json) + +:::tip For local development, we recommend using the oauth method. If you're scheduling dbt on a server, you should use the service account auth method instead. +::: BigQuery targets should be set up using the following configuration in your `profiles.yml` file. There are a number of [optional configurations](#optional-configurations) you may specify as well. @@ -495,14 +500,6 @@ my-profile: -## Required permissions - -BigQuery's permission model is dissimilar from more conventional databases like Snowflake and Redshift. The following permissions are required for dbt user accounts: -- BigQuery Data Editor -- BigQuery User - -This set of permissions will permit dbt users to read from and create tables and views in a BigQuery project. - ## Local OAuth gcloud setup To connect to BigQuery using the `oauth` method, follow these steps: diff --git a/website/snippets/_setup-pages-intro.md b/website/snippets/_setup-pages-intro.md new file mode 100644 index 00000000000..79bf558afc2 --- /dev/null +++ b/website/snippets/_setup-pages-intro.md @@ -0,0 +1,23 @@ +
      +
    • Maintained by: {props.meta.maintained_by}
    • +
    • Authors: {props.meta.authors}
    • +
    • GitHub repo: {props.meta.github_repo}
    • +
    • PyPI package: {props.meta.pypi_package}
    • +
    • Slack channel: {props.meta.slack_channel_name}
    • +
    • Supported dbt Core version: {props.meta.min_core_version} and newer
    • +
    • dbt Cloud support: {props.meta.cloud_support}
    • +
    • Minimum data platform version: {props.meta.min_supported_version}
    • +
    + + +

    Installing {props.meta.pypi_package}

    + +Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: + +pip install {props.meta.pypi_package} + +

    Configuring {props.meta.pypi_package}

    + +

    For {props.meta.platform_name}-specific configuration, please refer to {props.meta.platform_name} configs.

    + +

    For further info, refer to the GitHub repository: {props.meta.github_repo}

    diff --git a/website/snippets/setup-pages-intro.md b/website/snippets/setup-pages-intro.md deleted file mode 100644 index bae87933f1d..00000000000 --- a/website/snippets/setup-pages-intro.md +++ /dev/null @@ -1,11 +0,0 @@ -

    Installing {frontMatter.meta.pypi_package}

    - -Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: - -pip install {frontMatter.meta.pypi_package} - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    To optimize performance and for {frontMatter.meta.platform_name}-specific configuration please refer to {frontMatter.meta.platform_name} configs

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    From f149cdcbbe3b490e32f530e371f2f18d15e4a0dd Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 15 Jun 2023 20:06:32 +0100 Subject: [PATCH 04/12] adding partial --- website/docs/docs/core/connect-data-platform/bigquery-setup.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index af4a5ea886f..863f9125250 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -17,8 +17,6 @@ meta: -## Test - import SetUpPages from '/snippets/_setup-pages-intro.md'; From fac6f8031d189deba64e27c6b77ea0dc54c8663f Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 16 Jun 2023 14:04:28 +0100 Subject: [PATCH 05/12] add partial code --- .../connect-data-platform/alloydb-setup.md | 14 ++------ .../connect-data-platform/athena-setup.md | 27 ++------------- .../azuresynapse-setup.md | 27 ++------------- .../connect-data-platform/bigquery-setup.md | 2 ++ .../connect-data-platform/clickhouse-setup.md | 29 ++-------------- .../connect-data-platform/databend-setup.md | 29 ++-------------- .../connect-data-platform/databricks-setup.md | 30 ++--------------- .../connect-data-platform/decodable-setup.md | 30 ++--------------- .../core/connect-data-platform/doris-setup.md | 28 ++-------------- .../connect-data-platform/dremio-setup.md | 30 ++--------------- .../connect-data-platform/duckdb-setup.md | 28 ++-------------- .../connect-data-platform/exasol-setup.md | 29 ++-------------- .../connect-data-platform/fabric-setup.md | 27 ++------------- .../core/connect-data-platform/fal-setup.md | 31 ++--------------- .../connect-data-platform/firebolt-setup.md | 29 ++-------------- .../core/connect-data-platform/glue-setup.md | 29 ++-------------- .../connect-data-platform/greenplum-setup.md | 29 ++-------------- .../core/connect-data-platform/hive-setup.md | 29 ++-------------- .../connect-data-platform/ibmdb2-setup.md | 29 ++-------------- .../connect-data-platform/impala-setup.md | 29 ++-------------- .../core/connect-data-platform/infer-setup.md | 27 ++------------- .../connect-data-platform/iomete-setup.md | 30 ++--------------- .../core/connect-data-platform/layer-setup.md | 29 ++-------------- .../materialize-setup.md | 27 ++------------- .../connect-data-platform/mindsdb-setup.md | 30 ++--------------- .../core/connect-data-platform/mssql-setup.md | 28 ++-------------- .../core/connect-data-platform/mysql-setup.md | 27 ++------------- .../connect-data-platform/redshift-setup.md | 28 ++-------------- .../connect-data-platform/rockset-setup.md | 28 ++-------------- .../singlestore-setup.md | 30 ++--------------- .../connect-data-platform/snowflake-setup.md | 28 ++-------------- .../core/connect-data-platform/spark-setup.md | 28 +++------------- .../connect-data-platform/sqlite-setup.md | 29 ++-------------- .../connect-data-platform/teradata-setup.md | 28 ++-------------- .../core/connect-data-platform/tidb-setup.md | 29 ++-------------- .../core/connect-data-platform/trino-setup.md | 33 ++----------------- .../connect-data-platform/vertica-setup.md | 26 ++------------- website/snippets/_setup-pages-intro.md | 3 +- 38 files changed, 80 insertions(+), 943 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/alloydb-setup.md b/website/docs/docs/core/connect-data-platform/alloydb-setup.md index c3f3ee9cfca..db2117a13ee 100644 --- a/website/docs/docs/core/connect-data-platform/alloydb-setup.md +++ b/website/docs/docs/core/connect-data-platform/alloydb-setup.md @@ -14,18 +14,10 @@ meta: config_page: '/reference/resource-configs/postgres-configs' --- -## Overview of AlloyDB support +import SetUpPages from '/snippets/_setup-pages-intro.md'; + + -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    ## Profile Configuration diff --git a/website/docs/docs/core/connect-data-platform/athena-setup.md b/website/docs/docs/core/connect-data-platform/athena-setup.md index db218110dc1..468ba7a7847 100644 --- a/website/docs/docs/core/connect-data-platform/athena-setup.md +++ b/website/docs/docs/core/connect-data-platform/athena-setup.md @@ -15,32 +15,11 @@ meta: config_page: '/reference/resource-configs/no-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    + -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to Athena with dbt-athena diff --git a/website/docs/docs/core/connect-data-platform/azuresynapse-setup.md b/website/docs/docs/core/connect-data-platform/azuresynapse-setup.md index 073e95530c1..8a4d6b61004 100644 --- a/website/docs/docs/core/connect-data-platform/azuresynapse-setup.md +++ b/website/docs/docs/core/connect-data-platform/azuresynapse-setup.md @@ -24,32 +24,11 @@ Refer to [Microsoft Fabric Synapse Data Warehouse](/docs/core/connect-data-platf ::: -

    Overview of {frontMatter.meta.pypi_package}

    + -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + :::info Dedicated SQL only diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 8512feeeb83..6e634fc744c 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -17,6 +17,8 @@ meta: + + import SetUpPages from '/snippets/_setup-pages-intro.md'; diff --git a/website/docs/docs/core/connect-data-platform/clickhouse-setup.md b/website/docs/docs/core/connect-data-platform/clickhouse-setup.md index fb0965398a2..fce367be812 100644 --- a/website/docs/docs/core/connect-data-platform/clickhouse-setup.md +++ b/website/docs/docs/core/connect-data-platform/clickhouse-setup.md @@ -17,34 +17,9 @@ meta: Some core functionality may be limited. If you're interested in contributing, check out the source code for each repository listed below. +import SetUpPages from '/snippets/_setup-pages-intro.md'; -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to ClickHouse with **dbt-clickhouse** diff --git a/website/docs/docs/core/connect-data-platform/databend-setup.md b/website/docs/docs/core/connect-data-platform/databend-setup.md index daccd14f6c3..5442327fb27 100644 --- a/website/docs/docs/core/connect-data-platform/databend-setup.md +++ b/website/docs/docs/core/connect-data-platform/databend-setup.md @@ -22,34 +22,9 @@ If you're interested in contributing, check out the source code repository liste ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connecting to Databend Cloud with **dbt-databend-cloud** diff --git a/website/docs/docs/core/connect-data-platform/databricks-setup.md b/website/docs/docs/core/connect-data-platform/databricks-setup.md index eef6522a8f5..4792dceab3b 100644 --- a/website/docs/docs/core/connect-data-platform/databricks-setup.md +++ b/website/docs/docs/core/connect-data-platform/databricks-setup.md @@ -18,35 +18,9 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -## Installation and Distribution - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + `dbt-databricks` is the recommend adapter for Databricks diff --git a/website/docs/docs/core/connect-data-platform/decodable-setup.md b/website/docs/docs/core/connect-data-platform/decodable-setup.md index b43521732d4..6c3cb487885 100644 --- a/website/docs/docs/core/connect-data-platform/decodable-setup.md +++ b/website/docs/docs/core/connect-data-platform/decodable-setup.md @@ -21,35 +21,9 @@ meta: Some core functionality may be limited. If you're interested in contributing, see the source code for the repository listed below. ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version}
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -dbt-decodable is also available on PyPI. pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -
    -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration.

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connecting to Decodable with **dbt-decodable** Do the following steps to connect to Decodable with dbt. diff --git a/website/docs/docs/core/connect-data-platform/doris-setup.md b/website/docs/docs/core/connect-data-platform/doris-setup.md index a7e2ba1ba3e..882e6c3ba25 100644 --- a/website/docs/docs/core/connect-data-platform/doris-setup.md +++ b/website/docs/docs/core/connect-data-platform/doris-setup.md @@ -15,33 +15,9 @@ meta: config_page: '/reference/resource-configs/doris-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to Doris/SelectDB with **dbt-doris** diff --git a/website/docs/docs/core/connect-data-platform/dremio-setup.md b/website/docs/docs/core/connect-data-platform/dremio-setup.md index 4d10464400f..a6ac60490cb 100644 --- a/website/docs/docs/core/connect-data-platform/dremio-setup.md +++ b/website/docs/docs/core/connect-data-platform/dremio-setup.md @@ -20,36 +20,10 @@ meta: Some core functionality may be limited. If you're interested in contributing, check out the source code for each repository listed below. ::: +import SetUpPages from '/snippets/_setup-pages-intro.md'; -

    Overview of {frontMatter.meta.pypi_package}

    + -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    - -Follow the repository's link for os dependencies. ## Prerequisites for Dremio Cloud Before connecting from project to Dremio Cloud, follow these prerequisite steps: diff --git a/website/docs/docs/core/connect-data-platform/duckdb-setup.md b/website/docs/docs/core/connect-data-platform/duckdb-setup.md index 7896e4abeae..3792a806e51 100644 --- a/website/docs/docs/core/connect-data-platform/duckdb-setup.md +++ b/website/docs/docs/core/connect-data-platform/duckdb-setup.md @@ -21,33 +21,9 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to DuckDB with dbt-duckdb diff --git a/website/docs/docs/core/connect-data-platform/exasol-setup.md b/website/docs/docs/core/connect-data-platform/exasol-setup.md index 2bf4cd7ffac..509ccd67e84 100644 --- a/website/docs/docs/core/connect-data-platform/exasol-setup.md +++ b/website/docs/docs/core/connect-data-platform/exasol-setup.md @@ -21,34 +21,9 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    - dbt-exasol + ### Connecting to Exasol with **dbt-exasol** diff --git a/website/docs/docs/core/connect-data-platform/fabric-setup.md b/website/docs/docs/core/connect-data-platform/fabric-setup.md index aa7784d96ec..84641753f88 100644 --- a/website/docs/docs/core/connect-data-platform/fabric-setup.md +++ b/website/docs/docs/core/connect-data-platform/fabric-setup.md @@ -21,31 +21,8 @@ To learn how to set up dbt with Azure Synapse Dedicated Pools, see [Microsoft Az ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ### Prerequisites diff --git a/website/docs/docs/core/connect-data-platform/fal-setup.md b/website/docs/docs/core/connect-data-platform/fal-setup.md index ef4998e8c1b..24fe7033d89 100644 --- a/website/docs/docs/core/connect-data-platform/fal-setup.md +++ b/website/docs/docs/core/connect-data-platform/fal-setup.md @@ -21,35 +21,8 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package}[<sql-adapter>] - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    You must install the adapter for SQL transformations and data storage independently from dbt-fal.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Setting up fal with other adapter diff --git a/website/docs/docs/core/connect-data-platform/firebolt-setup.md b/website/docs/docs/core/connect-data-platform/firebolt-setup.md index c7a5a543512..6500805c094 100644 --- a/website/docs/docs/core/connect-data-platform/firebolt-setup.md +++ b/website/docs/docs/core/connect-data-platform/firebolt-setup.md @@ -19,33 +19,8 @@ meta: Some core functionality may be limited. If you're interested in contributing, check out the source code for the repository listed below. -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + For other information including Firebolt feature support, see the [GitHub README](https://github.com/firebolt-db/dbt-firebolt/blob/main/README.md) and the [changelog](https://github.com/firebolt-db/dbt-firebolt/blob/main/CHANGELOG.md). diff --git a/website/docs/docs/core/connect-data-platform/glue-setup.md b/website/docs/docs/core/connect-data-platform/glue-setup.md index e0fb9556853..42f80046f46 100644 --- a/website/docs/docs/core/connect-data-platform/glue-setup.md +++ b/website/docs/docs/core/connect-data-platform/glue-setup.md @@ -22,33 +22,8 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + For further (and more likely up-to-date) info, see the [README](https://github.com/aws-samples/dbt-glue#readme) diff --git a/website/docs/docs/core/connect-data-platform/greenplum-setup.md b/website/docs/docs/core/connect-data-platform/greenplum-setup.md index 06ada19a1e9..e9ea421b2f5 100644 --- a/website/docs/docs/core/connect-data-platform/greenplum-setup.md +++ b/website/docs/docs/core/connect-data-platform/greenplum-setup.md @@ -16,33 +16,8 @@ meta: config_page: '/reference/resource-configs/greenplum-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + For further (and more likely up-to-date) info, see the [README](https://github.com/markporoshin/dbt-greenplum#README.md) diff --git a/website/docs/docs/core/connect-data-platform/hive-setup.md b/website/docs/docs/core/connect-data-platform/hive-setup.md index 61a929c58da..f180a33662f 100644 --- a/website/docs/docs/core/connect-data-platform/hive-setup.md +++ b/website/docs/docs/core/connect-data-platform/hive-setup.md @@ -16,33 +16,8 @@ meta: config_page: '/reference/resource-configs/hive-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connection Methods diff --git a/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md b/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md index cb6c7459418..12028fde046 100644 --- a/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md +++ b/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md @@ -22,33 +22,8 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -## Overview of dbt-ibmdb2 - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + This is an experimental plugin: diff --git a/website/docs/docs/core/connect-data-platform/impala-setup.md b/website/docs/docs/core/connect-data-platform/impala-setup.md index 0a0f1b955a1..da0ddffa05b 100644 --- a/website/docs/docs/core/connect-data-platform/impala-setup.md +++ b/website/docs/docs/core/connect-data-platform/impala-setup.md @@ -16,33 +16,8 @@ meta: config_page: '/reference/resource-configs/impala-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connection Methods diff --git a/website/docs/docs/core/connect-data-platform/infer-setup.md b/website/docs/docs/core/connect-data-platform/infer-setup.md index 430c5e47f85..2969e871609 100644 --- a/website/docs/docs/core/connect-data-platform/infer-setup.md +++ b/website/docs/docs/core/connect-data-platform/infer-setup.md @@ -16,31 +16,8 @@ meta: min_supported_version: n/a --- -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connecting to Infer with **dbt-infer** diff --git a/website/docs/docs/core/connect-data-platform/iomete-setup.md b/website/docs/docs/core/connect-data-platform/iomete-setup.md index bc015141c85..66ef526ec8c 100644 --- a/website/docs/docs/core/connect-data-platform/iomete-setup.md +++ b/website/docs/docs/core/connect-data-platform/iomete-setup.md @@ -16,35 +16,9 @@ meta: config_page: '/reference/resource-configs/no-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -## Installation and Distribution - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + Set up a iomete Target diff --git a/website/docs/docs/core/connect-data-platform/layer-setup.md b/website/docs/docs/core/connect-data-platform/layer-setup.md index f065c0c7313..051094297a2 100644 --- a/website/docs/docs/core/connect-data-platform/layer-setup.md +++ b/website/docs/docs/core/connect-data-platform/layer-setup.md @@ -17,34 +17,9 @@ meta: --- -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ### Profile Configuration diff --git a/website/docs/docs/core/connect-data-platform/materialize-setup.md b/website/docs/docs/core/connect-data-platform/materialize-setup.md index c8777c29490..ec0034dcd37 100644 --- a/website/docs/docs/core/connect-data-platform/materialize-setup.md +++ b/website/docs/docs/core/connect-data-platform/materialize-setup.md @@ -22,32 +22,9 @@ Certain core functionality may vary. If you would like to report a bug, request ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration, please refer to {frontMatter.meta.platform_name} Configuration.

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to Materialize diff --git a/website/docs/docs/core/connect-data-platform/mindsdb-setup.md b/website/docs/docs/core/connect-data-platform/mindsdb-setup.md index e6b8c5decaa..47d9d311ff9 100644 --- a/website/docs/docs/core/connect-data-platform/mindsdb-setup.md +++ b/website/docs/docs/core/connect-data-platform/mindsdb-setup.md @@ -19,35 +19,9 @@ meta: The dbt-mindsdb package allows dbt to connect to [MindsDB](https://github.com/mindsdb/mindsdb). -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -## Installation - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Configurations diff --git a/website/docs/docs/core/connect-data-platform/mssql-setup.md b/website/docs/docs/core/connect-data-platform/mssql-setup.md index 5efcc454823..f58827c3554 100644 --- a/website/docs/docs/core/connect-data-platform/mssql-setup.md +++ b/website/docs/docs/core/connect-data-platform/mssql-setup.md @@ -22,33 +22,9 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + :::tip Default settings change in dbt-sqlserver v1.2 / ODBC Driver 18 diff --git a/website/docs/docs/core/connect-data-platform/mysql-setup.md b/website/docs/docs/core/connect-data-platform/mysql-setup.md index 1df6e205272..4b9224e0a0d 100644 --- a/website/docs/docs/core/connect-data-platform/mysql-setup.md +++ b/website/docs/docs/core/connect-data-platform/mysql-setup.md @@ -22,32 +22,9 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + This is an experimental plugin: - It has not been tested extensively. diff --git a/website/docs/docs/core/connect-data-platform/redshift-setup.md b/website/docs/docs/core/connect-data-platform/redshift-setup.md index 7d5fdbf7a97..3ff959199e0 100644 --- a/website/docs/docs/core/connect-data-platform/redshift-setup.md +++ b/website/docs/docs/core/connect-data-platform/redshift-setup.md @@ -18,33 +18,9 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specific configuration, refer to {frontMatter.meta.platform_name} Configuration.

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}.

    + ## Authentication Methods diff --git a/website/docs/docs/core/connect-data-platform/rockset-setup.md b/website/docs/docs/core/connect-data-platform/rockset-setup.md index 4a146829a03..372a6c0c538 100644 --- a/website/docs/docs/core/connect-data-platform/rockset-setup.md +++ b/website/docs/docs/core/connect-data-platform/rockset-setup.md @@ -22,33 +22,9 @@ Certain core functionality may vary. If you would like to report a bug, request ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to Rockset with **dbt-rockset** diff --git a/website/docs/docs/core/connect-data-platform/singlestore-setup.md b/website/docs/docs/core/connect-data-platform/singlestore-setup.md index a63466542a9..285c41bafc9 100644 --- a/website/docs/docs/core/connect-data-platform/singlestore-setup.md +++ b/website/docs/docs/core/connect-data-platform/singlestore-setup.md @@ -22,35 +22,9 @@ Certain core functionality may vary. If you would like to report a bug, request ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -## Installation and Distribution - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ### Set up a SingleStore Target diff --git a/website/docs/docs/core/connect-data-platform/snowflake-setup.md b/website/docs/docs/core/connect-data-platform/snowflake-setup.md index 147cfb87867..9bda93d2187 100644 --- a/website/docs/docs/core/connect-data-platform/snowflake-setup.md +++ b/website/docs/docs/core/connect-data-platform/snowflake-setup.md @@ -18,34 +18,10 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Authentication Methods diff --git a/website/docs/docs/core/connect-data-platform/spark-setup.md b/website/docs/docs/core/connect-data-platform/spark-setup.md index 00de640ee05..818cf9dfb2f 100644 --- a/website/docs/docs/core/connect-data-platform/spark-setup.md +++ b/website/docs/docs/core/connect-data-platform/spark-setup.md @@ -24,28 +24,14 @@ meta: See [Databricks setup](#databricks-setup) for the Databricks version of this page. ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    + -

    Installing {frontMatter.meta.pypi_package}

    -pip is the easiest way to install the adapter: +A note about connecting using an ODBC driver -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -If connecting to Databricks via ODBC driver, it requires `pyodbc`. Depending on your system, you can install it seperately or via pip. See the [`pyodbc` wiki](https://github.com/mkleehammer/pyodbc/wiki/Install) for OS-specific installation details. +If connecting to Databricks via ODBC driver, it requires `pyodbc`. Depending on your system, you can install it separately or via pip. See the [`pyodbc` wiki](https://github.com/mkleehammer/pyodbc/wiki/Install) for OS-specific installation details. If connecting to a Spark cluster via the generic thrift or http methods, it requires `PyHive`. @@ -66,12 +52,6 @@ $ pip install "dbt-spark[session]" -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specific configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    - ## Connection Methods dbt-spark can connect to Spark clusters by three different methods: diff --git a/website/docs/docs/core/connect-data-platform/sqlite-setup.md b/website/docs/docs/core/connect-data-platform/sqlite-setup.md index 3da902a6f80..20897ea90d7 100644 --- a/website/docs/docs/core/connect-data-platform/sqlite-setup.md +++ b/website/docs/docs/core/connect-data-platform/sqlite-setup.md @@ -22,34 +22,9 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + Starting with the release of dbt-core 1.0.0, versions of dbt-sqlite are aligned to the same major+minor [version](https://semver.org/) of dbt-core. - versions 1.1.x of this adapter work with dbt-core 1.1.x diff --git a/website/docs/docs/core/connect-data-platform/teradata-setup.md b/website/docs/docs/core/connect-data-platform/teradata-setup.md index 1fe33ff8929..60ced3ac436 100644 --- a/website/docs/docs/core/connect-data-platform/teradata-setup.md +++ b/website/docs/docs/core/connect-data-platform/teradata-setup.md @@ -19,33 +19,9 @@ meta: Some core functionality may be limited. If you're interested in contributing, check out the source code for the repository listed below. -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ### Connecting to Teradata diff --git a/website/docs/docs/core/connect-data-platform/tidb-setup.md b/website/docs/docs/core/connect-data-platform/tidb-setup.md index e2205c4665e..253497b37ba 100644 --- a/website/docs/docs/core/connect-data-platform/tidb-setup.md +++ b/website/docs/docs/core/connect-data-platform/tidb-setup.md @@ -24,34 +24,9 @@ If you're interested in contributing, check out the source code repository liste ::: -

    Overview of {frontMatter.meta.pypi_package}

    - -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; + ## Connecting to TiDB with **dbt-tidb** diff --git a/website/docs/docs/core/connect-data-platform/trino-setup.md b/website/docs/docs/core/connect-data-platform/trino-setup.md index 711e735ab6d..918ecdaba74 100644 --- a/website/docs/docs/core/connect-data-platform/trino-setup.md +++ b/website/docs/docs/core/connect-data-platform/trino-setup.md @@ -18,38 +18,9 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - -:::info Vendor-supported plugin - -Certain core functionality may vary. If you would like to report a bug, request a feature, or contribute, you can check out the linked repository and open an issue. - -::: - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Connecting to Starburst/Trino diff --git a/website/docs/docs/core/connect-data-platform/vertica-setup.md b/website/docs/docs/core/connect-data-platform/vertica-setup.md index fbb8de6b301..dda242393b5 100644 --- a/website/docs/docs/core/connect-data-platform/vertica-setup.md +++ b/website/docs/docs/core/connect-data-platform/vertica-setup.md @@ -21,31 +21,9 @@ If you're interested in contributing, check out the source code for each reposit ::: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.pypi_package} specific configuration please refer to {frontMatter.meta.platform_name} Configuration.

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}.

    +

    Connecting to {frontMatter.meta.platform_name} with {frontMatter.meta.pypi_package}

    diff --git a/website/snippets/_setup-pages-intro.md b/website/snippets/_setup-pages-intro.md index 79bf558afc2..cc68aac913f 100644 --- a/website/snippets/_setup-pages-intro.md +++ b/website/snippets/_setup-pages-intro.md @@ -1,3 +1,4 @@ +
    • Maintained by: {props.meta.maintained_by}
    • Authors: {props.meta.authors}
    • @@ -9,11 +10,9 @@
    • Minimum data platform version: {props.meta.min_supported_version}
    -

    Installing {props.meta.pypi_package}

    Use `pip` to install the adapter, which automatically installs `dbt-core` and any additional dependencies. Use the following command for installation: - pip install {props.meta.pypi_package}

    Configuring {props.meta.pypi_package}

    From a07a8839afdeeaef959bac866a0be6672a35b2d2 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 16 Jun 2023 14:08:17 +0100 Subject: [PATCH 06/12] add partial --- .../connect-data-platform/fabric-setup.md | 2 ++ .../core/connect-data-platform/fal-setup.md | 2 ++ .../connect-data-platform/firebolt-setup.md | 2 ++ .../core/connect-data-platform/glue-setup.md | 2 ++ .../connect-data-platform/greenplum-setup.md | 2 ++ .../core/connect-data-platform/hive-setup.md | 2 ++ .../connect-data-platform/ibmdb2-setup.md | 2 ++ .../connect-data-platform/impala-setup.md | 1 + .../core/connect-data-platform/infer-setup.md | 2 ++ .../connect-data-platform/iomete-setup.md | 1 + .../connect-data-platform/oracle-setup.md | 29 ++----------------- .../connect-data-platform/postgres-setup.md | 28 ++---------------- 12 files changed, 22 insertions(+), 53 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/fabric-setup.md b/website/docs/docs/core/connect-data-platform/fabric-setup.md index 84641753f88..6d0a455d1f8 100644 --- a/website/docs/docs/core/connect-data-platform/fabric-setup.md +++ b/website/docs/docs/core/connect-data-platform/fabric-setup.md @@ -22,8 +22,10 @@ To learn how to set up dbt with Azure Synapse Dedicated Pools, see [Microsoft Az ::: import SetUpPages from '/snippets/_setup-pages-intro.md'; + + ### Prerequisites On Debian/Ubuntu make sure you have the ODBC header files before installing diff --git a/website/docs/docs/core/connect-data-platform/fal-setup.md b/website/docs/docs/core/connect-data-platform/fal-setup.md index 24fe7033d89..76539d67c54 100644 --- a/website/docs/docs/core/connect-data-platform/fal-setup.md +++ b/website/docs/docs/core/connect-data-platform/fal-setup.md @@ -22,9 +22,11 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: import SetUpPages from '/snippets/_setup-pages-intro.md'; + + ## Setting up fal with other adapter [fal](http://github.com/fal-ai/fal) offers a Python runtime independent from what database you are using and integrates seamlessly with dbt. It works by downloading the data as a Pandas DataFrame, transforming it in a local Python runtime and uploading it to the database. The only configuration change you need to do is adding it to the `profiles.yml` and setting the `db_profile` property as the database profile you are already using. diff --git a/website/docs/docs/core/connect-data-platform/firebolt-setup.md b/website/docs/docs/core/connect-data-platform/firebolt-setup.md index 6500805c094..8fb91dea299 100644 --- a/website/docs/docs/core/connect-data-platform/firebolt-setup.md +++ b/website/docs/docs/core/connect-data-platform/firebolt-setup.md @@ -20,9 +20,11 @@ Some core functionality may be limited. If you're interested in contributing, ch import SetUpPages from '/snippets/_setup-pages-intro.md'; + + For other information including Firebolt feature support, see the [GitHub README](https://github.com/firebolt-db/dbt-firebolt/blob/main/README.md) and the [changelog](https://github.com/firebolt-db/dbt-firebolt/blob/main/CHANGELOG.md). diff --git a/website/docs/docs/core/connect-data-platform/glue-setup.md b/website/docs/docs/core/connect-data-platform/glue-setup.md index 42f80046f46..ca7d5503d57 100644 --- a/website/docs/docs/core/connect-data-platform/glue-setup.md +++ b/website/docs/docs/core/connect-data-platform/glue-setup.md @@ -23,8 +23,10 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: import SetUpPages from '/snippets/_setup-pages-intro.md'; + + For further (and more likely up-to-date) info, see the [README](https://github.com/aws-samples/dbt-glue#readme) diff --git a/website/docs/docs/core/connect-data-platform/greenplum-setup.md b/website/docs/docs/core/connect-data-platform/greenplum-setup.md index e9ea421b2f5..523a503b128 100644 --- a/website/docs/docs/core/connect-data-platform/greenplum-setup.md +++ b/website/docs/docs/core/connect-data-platform/greenplum-setup.md @@ -17,8 +17,10 @@ meta: --- import SetUpPages from '/snippets/_setup-pages-intro.md'; + + For further (and more likely up-to-date) info, see the [README](https://github.com/markporoshin/dbt-greenplum#README.md) diff --git a/website/docs/docs/core/connect-data-platform/hive-setup.md b/website/docs/docs/core/connect-data-platform/hive-setup.md index f180a33662f..92210162324 100644 --- a/website/docs/docs/core/connect-data-platform/hive-setup.md +++ b/website/docs/docs/core/connect-data-platform/hive-setup.md @@ -17,9 +17,11 @@ meta: --- import SetUpPages from '/snippets/_setup-pages-intro.md'; + + ## Connection Methods dbt-hive can connect to Apache Hive and Cloudera Data Platform clusters. The [Impyla](https://github.com/cloudera/impyla/) library is used to establish connections to Hive. diff --git a/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md b/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md index 12028fde046..692342466b0 100644 --- a/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md +++ b/website/docs/docs/core/connect-data-platform/ibmdb2-setup.md @@ -23,9 +23,11 @@ Some core functionality may be limited. If you're interested in contributing, ch ::: import SetUpPages from '/snippets/_setup-pages-intro.md'; + + This is an experimental plugin: - We have not tested it extensively - Tested with [dbt-adapter-tests](https://pypi.org/project/pytest-dbt-adapter/) and DB2 LUW on Mac OS+RHEL8 diff --git a/website/docs/docs/core/connect-data-platform/impala-setup.md b/website/docs/docs/core/connect-data-platform/impala-setup.md index da0ddffa05b..df82cab6563 100644 --- a/website/docs/docs/core/connect-data-platform/impala-setup.md +++ b/website/docs/docs/core/connect-data-platform/impala-setup.md @@ -17,6 +17,7 @@ meta: --- import SetUpPages from '/snippets/_setup-pages-intro.md'; + diff --git a/website/docs/docs/core/connect-data-platform/infer-setup.md b/website/docs/docs/core/connect-data-platform/infer-setup.md index 2969e871609..7642c553cc4 100644 --- a/website/docs/docs/core/connect-data-platform/infer-setup.md +++ b/website/docs/docs/core/connect-data-platform/infer-setup.md @@ -17,9 +17,11 @@ meta: --- import SetUpPages from '/snippets/_setup-pages-intro.md'; + + ## Connecting to Infer with **dbt-infer** Infer allows you to perform advanced ML Analytics within SQL as if native to your data warehouse. diff --git a/website/docs/docs/core/connect-data-platform/iomete-setup.md b/website/docs/docs/core/connect-data-platform/iomete-setup.md index 66ef526ec8c..2f2d18b1e47 100644 --- a/website/docs/docs/core/connect-data-platform/iomete-setup.md +++ b/website/docs/docs/core/connect-data-platform/iomete-setup.md @@ -21,6 +21,7 @@ import SetUpPages from '/snippets/_setup-pages-intro.md'; + Set up a iomete Target iomete targets should be set up using the following configuration in your profiles.yml file. diff --git a/website/docs/docs/core/connect-data-platform/oracle-setup.md b/website/docs/docs/core/connect-data-platform/oracle-setup.md index 0d677c1c90b..380ab9cf4a2 100644 --- a/website/docs/docs/core/connect-data-platform/oracle-setup.md +++ b/website/docs/docs/core/connect-data-platform/oracle-setup.md @@ -16,35 +16,10 @@ meta: config_page: '/reference/resource-configs/oracle-configs' --- -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    + -## Installation - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    ### Configure the Python driver mode diff --git a/website/docs/docs/core/connect-data-platform/postgres-setup.md b/website/docs/docs/core/connect-data-platform/postgres-setup.md index a6948e6f1ad..2ed0fb9336d 100644 --- a/website/docs/docs/core/connect-data-platform/postgres-setup.md +++ b/website/docs/docs/core/connect-data-platform/postgres-setup.md @@ -18,33 +18,9 @@ meta: -

    Overview of {frontMatter.meta.pypi_package}

    +import SetUpPages from '/snippets/_setup-pages-intro.md'; -
      -
    • Maintained by: {frontMatter.meta.maintained_by}
    • -
    • Authors: {frontMatter.meta.authors}
    • -
    • GitHub repo: {frontMatter.meta.github_repo}
    • -
    • PyPI package: {frontMatter.meta.pypi_package}
    • -
    • Slack channel: {frontMatter.meta.slack_channel_name}
    • -
    • Supported dbt Core version: {frontMatter.meta.min_core_version} and newer
    • -
    • dbt Cloud support: {frontMatter.meta.cloud_support}
    • -
    • Minimum data platform version: {frontMatter.meta.min_supported_version}
    • -
    - - -

    Installing {frontMatter.meta.pypi_package}

    - -pip is the easiest way to install the adapter: - -pip install {frontMatter.meta.pypi_package} - -

    Installing {frontMatter.meta.pypi_package} will also install dbt-core and any other dependencies.

    - -

    Configuring {frontMatter.meta.pypi_package}

    - -

    For {frontMatter.meta.platform_name}-specifc configuration please refer to {frontMatter.meta.platform_name} Configuration

    - -

    For further info, refer to the GitHub repository: {frontMatter.meta.github_repo}

    + ## Profile Configuration From 2fca17706d2d5c8f036de7a8dc367d79cc18ed10 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 16 Jun 2023 17:09:08 +0100 Subject: [PATCH 07/12] frontmatter --- .../docs/docs/core/connect-data-platform/bigquery-setup.md | 2 +- .../docs/docs/core/connect-data-platform/snowflake-setup.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 6e634fc744c..45b35487e5e 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -17,7 +17,7 @@ meta: - + import SetUpPages from '/snippets/_setup-pages-intro.md'; diff --git a/website/docs/docs/core/connect-data-platform/snowflake-setup.md b/website/docs/docs/core/connect-data-platform/snowflake-setup.md index 9bda93d2187..3826bfae4e9 100644 --- a/website/docs/docs/core/connect-data-platform/snowflake-setup.md +++ b/website/docs/docs/core/connect-data-platform/snowflake-setup.md @@ -18,10 +18,10 @@ meta: - import SetUpPages from '/snippets/_setup-pages-intro.md'; - + + ## Authentication Methods From 29367b20e208ace8fb127b09a2ed014f863991eb Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Tue, 20 Jun 2023 16:14:28 +0100 Subject: [PATCH 08/12] bigquery --- .../connect-data-platform/bigquery-setup.md | 54 +++++++++++-------- 1 file changed, 31 insertions(+), 23 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index 45b35487e5e..a4cf813499e 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -13,10 +13,12 @@ meta: slack_channel_link: 'https://getdbt.slack.com/archives/C99SNSRTK' platform_name: 'Big Query' config_page: '/reference/resource-configs/bigquery-configs' + addl_frontmatter: 'hello world' --- + import SetUpPages from '/snippets/_setup-pages-intro.md'; @@ -33,25 +35,16 @@ You need to have the required [BigQuery permissions](https://cloud.google.com/bi This set of permissions will permit dbt users to read from and create tables and views in a BigQuery project. ## Authentication methods -You can specify BigQuery targets using one of four methods: - -| Auth method | Description | Supported | -| ----------- | ----------- | --------- | -| OAuth via gcloud | Recommended for local development - +You can specify BigQuery targets using four methods. BigQuery targets should be set up using the following configuration in your `profiles.yml` file. There are a number of [optional configurations](#optional-configurations) you may specify as well. 1. [OAuth via `gcloud`](#oauth-via-gcloud) -2. [OAuth token-based](#oauth-token-based) -3. [service account file](#service-account-file) -4. [service account json](#service-account-json) +2. [OAuth token-based](#oauth-token-based) +3. [Service account file](#service-account-file) +4. [Service account json](#service-account-json) :::tip -For local development, we recommend using the oauth method. If you're scheduling dbt on a server, you should use the service account auth method instead. +For local development, we recommend using the OAuth method. If you're scheduling dbt on a server, you should use the service account auth method instead. ::: - - -BigQuery targets should be set up using the following configuration in your `profiles.yml` file. There are a number of [optional configurations](#optional-configurations) you may specify as well. - ### OAuth via gcloud This connection method requires [local OAuth via `gcloud`](#local-oauth-gcloud-setup). @@ -79,7 +72,7 @@ my-bigquery-db: New in dbt v0.19.0 -If you do not specify a `project`/`database` and are using the `oauth` method, dbt will use the default `project` associated with your user, as defined by `gcloud config set`. +If you do not specify a `project`/`database` and are using the `OAuth` method, dbt will use the default `project` associated with your user, as defined by `gcloud config set`. ### OAuth Token-Based @@ -208,6 +201,17 @@ my-bigquery-db: ## Optional configurations +Use the following optional configurations to specify BigQuery targets in your `profiles.yml` file: + +- [**Priority**](#priority) — Configure the priority of dbt's BigQuery jobs using the `priority` configuration in your BigQuery profile. +- [**Timeouts and retries**](#timeouts-and-retries) — The dbt-bigquery plugin utilizes the BigQuery Python client library to submit queries, which involves job creation and execution. +- [**Dataset locations**](#dataset-locations) — Configure the location of BigQuery datasets using the location configuration in a BigQuery profile, specifying either a multi-regional location. +- [**Maximum bytes billed**](#maximum-bytes-billed) — Set maximum_bytes_billed value in a BigQuery profile to ensure queries don't exceed the configured threshold. +- [**OAuth 2.0 scopes for Google APIs**](#oauth-20-scopes-for-google-apis) — Use the scopes profile configuration to set up your own OAuth scopes for dbt +- [**Service Account impersonation**](#service-account-impersonation) — Authenticate with local OAuth to access to BigQuery resources based on the service account permissions. +- [**Execution project**](#execution-project) — You can optionally specify an execution_project for query execution billing. +- [**Running Python models on Dataproc**](#running-python-models-on-dataproc) — Utilize the integrated services of Dataproc and Cloud Storage to run dbt Python models in GCP. + ### Priority The `priority` for the BigQuery jobs that dbt executes can be configured with the `priority` configuration in your BigQuery profile. The `priority` field can be set to one of `batch` or `interactive`. For more information on query priority, consult the [BigQuery documentation](https://cloud.google.com/bigquery/docs/running-queries). @@ -234,7 +238,8 @@ The `dbt-bigquery` plugin uses the BigQuery Python client library to submit quer Some queries inevitably fail, at different points in process. To handle these cases, dbt supports fine-grained configuration for query timeouts and retries. -#### job_execution_timeout_seconds + + Use the `job_execution_timeout_seconds` configuration to set the number of seconds dbt should wait for queries to complete, after being submitted successfully. Of the four configurations that control timeout and retries, this one is the most common to use. @@ -263,14 +268,14 @@ my-profile: dataset: my_dataset job_execution_timeout_seconds: 600 # 10 minutes ``` - -#### job_creation_timeout_seconds + + It is also possible for a query job to fail to submit in the first place. You can configure the maximum timeout for the job creation step by configuring `job_creation_timeout_seconds`. No timeout is set by default. In the job creation step, dbt is simply submitting a query job to BigQuery's `Jobs.Insert` API, and receiving a query job ID in return. It should take a few seconds at most. In some rare situations, it could take longer. - -#### job_retries + + Google's BigQuery Python client has native support for retrying query jobs that time out, or queries that run into transient errors and are likely to succeed if run again. You can configure the maximum number of retries by configuring `job_retries`. @@ -282,7 +287,8 @@ In older versions of `dbt-bigquery`, the `job_retries` config was just called `r The default value is 1, meaning that dbt will retry failing queries exactly once. You can set the configuration to 0 to disable retries entirely. -#### job_retry_deadline_seconds + + After a query job times out, or encounters a transient error, dbt will wait one second before retrying the same query. In cases where queries are repeatedly timing out, this can add up to a long wait. You can set the `job_retry_deadline_seconds` configuration to set the total number of seconds you're willing to wait ("deadline") while retrying the same query. If dbt hits the deadline, it will give up and return an error. @@ -305,9 +311,11 @@ my-profile: job_retry_deadline_seconds: 1200 ``` - + + + @@ -504,7 +512,7 @@ my-profile: ## Local OAuth gcloud setup -To connect to BigQuery using the `oauth` method, follow these steps: +To connect to BigQuery using the `OAuth` method, follow these steps: 1. Make sure the `gcloud` command is [installed on your computer](https://cloud.google.com/sdk/downloads) 2. Activate the application-default account with From f6ed2831e4de4fc93087cb2796b2677a80289d42 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 29 Jun 2023 15:33:40 +0100 Subject: [PATCH 09/12] test --- .../docs/docs/core/connect-data-platform/bigquery-setup.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/website/docs/docs/core/connect-data-platform/bigquery-setup.md b/website/docs/docs/core/connect-data-platform/bigquery-setup.md index a4cf813499e..6c947edc684 100644 --- a/website/docs/docs/core/connect-data-platform/bigquery-setup.md +++ b/website/docs/docs/core/connect-data-platform/bigquery-setup.md @@ -13,11 +13,12 @@ meta: slack_channel_link: 'https://getdbt.slack.com/archives/C99SNSRTK' platform_name: 'Big Query' config_page: '/reference/resource-configs/bigquery-configs' - addl_frontmatter: 'hello world' + addl_frontmatter: 'a link world' --- +to join this channel, go to {frontMatter.meta.addl_frontmatter} for more info @@ -527,3 +528,5 @@ https://www.googleapis.com/auth/iam.test A browser window should open, and you should be prompted to log into your Google account. Once you've done that, dbt will use your OAuth'd credentials to connect to BigQuery! This command uses the `--scopes` flag to request access to Google Sheets. This makes it possible to transform data in Google Sheets using dbt. If your dbt project does not transform data in Google Sheets, then you may omit the `--scopes` flag. + + From 999b1ba80825aed54e0b7b8ac9f53923018970bb Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Mon, 20 Nov 2023 10:59:40 +0000 Subject: [PATCH 10/12] fix links --- website/docs/docs/core/connect-data-platform/fabric-setup.md | 2 +- .../docs/docs/core/connect-data-platform/materialize-setup.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/core/connect-data-platform/fabric-setup.md b/website/docs/docs/core/connect-data-platform/fabric-setup.md index c7faf5e0c67..11a8cf6f98b 100644 --- a/website/docs/docs/core/connect-data-platform/fabric-setup.md +++ b/website/docs/docs/core/connect-data-platform/fabric-setup.md @@ -4,7 +4,7 @@ description: "Read this guide to learn about the Microsoft Fabric Synapse Data W id: fabric-setup meta: maintained_by: Microsoft - authors: '[Microsoft](https://github.com/Microsoft)' + authors: 'Microsoft' github_repo: 'Microsoft/dbt-fabric' pypi_package: 'dbt-fabric' min_core_version: '1.4.0' diff --git a/website/docs/docs/core/connect-data-platform/materialize-setup.md b/website/docs/docs/core/connect-data-platform/materialize-setup.md index ec0034dcd37..70505fe1d65 100644 --- a/website/docs/docs/core/connect-data-platform/materialize-setup.md +++ b/website/docs/docs/core/connect-data-platform/materialize-setup.md @@ -6,7 +6,7 @@ meta: maintained_by: Materialize Inc. pypi_package: 'dbt-materialize' authors: 'Materialize team' - github_repo: 'MaterializeInc/materialize/blob/main/misc/dbt-materialize' + github_repo: 'MaterializeInc/materialize' min_core_version: 'v0.18.1' min_supported_version: 'v0.28.0' cloud_support: Not Supported From 5ea8046fe765c83ec43b1e1edd79dedd4ab933dd Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Mon, 20 Nov 2023 11:08:01 +0000 Subject: [PATCH 11/12] add guidance in adapters guide --- website/docs/guides/adapter-creation.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/adapter-creation.md b/website/docs/guides/adapter-creation.md index 8a9145f0258..aa4819e73d0 100644 --- a/website/docs/guides/adapter-creation.md +++ b/website/docs/guides/adapter-creation.md @@ -1108,7 +1108,7 @@ The following subjects need to be addressed across three pages of this docs site | How To... | File to change within `/website/docs/` | Action | Info to Include | |----------------------|--------------------------------------------------------------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Connect | `/docs/core/connect-data-platform/{MY-DATA-PLATFORM}-setup.md` | Create | Give all information needed to define a target in `~/.dbt/profiles.yml` and get `dbt debug` to connect to the database successfully. All possible configurations should be mentioned. | +| Connect | `/docs/core/connect-data-platform/{MY-DATA-PLATFORM}-setup.md` | Create | Give all information needed to define a target in `~/.dbt/profiles.yml` and get `dbt debug` to connect to the database successfully. All possible configurations should be mentioned. | | Configure | `reference/resource-configs/{MY-DATA-PLATFORM}-configs.md` | Create | What options and configuration specific to your data platform do users need to know? e.g. table distribution and indexing options, column_quoting policy, which incremental strategies are supported | | Discover and Install | `docs/supported-data-platforms.md` | Modify | Is it a vendor- or community- supported adapter? How to install Python adapter package? Ideally with pip and PyPI hosted package, but can also use `git+` link to GitHub Repo | | Add link to sidebar | `website/sidebars.js` | Modify | Add the document id to the correct location in the sidebar menu | @@ -1123,6 +1123,14 @@ Below are some recent pull requests made by partners to document their data plat - [SingleStore](https://github.com/dbt-labs/docs.getdbt.com/pull/1044) - [Firebolt](https://github.com/dbt-labs/docs.getdbt.com/pull/941) +Note — Use the following re-usable component to auto-fill the frontmatter content on your new page: + +```markdown +import SetUpPages from '/snippets/_setup-pages-intro.md'; + + +``` + ## Promote a new adapter The most important thing here is recognizing that people are successful in the community when they join, first and foremost, to engage authentically. From 8ce6765c2ab6b4e76bddb88e9054cfb4e5571bc8 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 20 Nov 2023 17:39:11 +0000 Subject: [PATCH 12/12] Update website/snippets/_setup-pages-intro.md Co-authored-by: Anders --- website/snippets/_setup-pages-intro.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/snippets/_setup-pages-intro.md b/website/snippets/_setup-pages-intro.md index cc68aac913f..44cbbb1a0c2 100644 --- a/website/snippets/_setup-pages-intro.md +++ b/website/snippets/_setup-pages-intro.md @@ -19,4 +19,3 @@ Use `pip` to install the adapter, which automatically installs `dbt-core` and an

    For {props.meta.platform_name}-specific configuration, please refer to {props.meta.platform_name} configs.

    -

    For further info, refer to the GitHub repository: {props.meta.github_repo}