Skip to content

Commit 40670b6

Browse files
Update teradata-configs.md
Editorial updates
1 parent 973cf87 commit 40670b6

File tree

1 file changed

+19
-14
lines changed

1 file changed

+19
-14
lines changed

website/docs/reference/resource-configs/teradata-configs.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -414,29 +414,34 @@ These steps collectively ensure that the valid_history strategy effectively mana
414414
```
415415
See [Collecting Statistics documentation](https://docs.teradata.com/r/76g1CuvvQlYBjb2WPIuk3g/RAyUdGfvREwbO9J0DMNpLw) for more information.
416416

417-
## dbt-external-tables
418-
* [dbt-external-tables](https://github.com/dbt-labs/dbt-external-tables) are supported with dbt-teradata from dbt-teradata v1.9.3 onwards.
419-
* Under the hood, dbt-teradata uses the concept of foreign tables to create tables from external sources. More information can be found [here](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Table-Statements/CREATE-FOREIGN-TABLE)
420-
* User need to add the dbt-external-tables packages as dependency and can be resolved with `dbt deps` command
417+
## The external tables package
418+
419+
The [dbt-external-tables](https://github.com/dbt-labs/dbt-external-tables) package is supported with the dbt-teradata adapter from v1.9.3 onwards. Under the hood, dbt-teradata uses the concept of foreign tables to create tables from external sources. More information can be found in the [Teradata documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Table-Statements/CREATE-FOREIGN-TABLE).
420+
421+
You need to add the `dbt-external-tables` package as a dependency:
422+
421423
```yaml
422424
packages:
423425
- package: dbt-labs/dbt_external_tables
424426
version: [">=0.9.0", "<1.0.0"]
425427
```
426-
* User need to add dispatch config for the project to pick the overridden macros from dbt-teradata package
428+
429+
You need to add the dispatch config for the project to pick the overridden macros from the dbt-teradata package:
430+
427431
```yaml
428432
dispatch:
429433
- macro_namespace: dbt_external_tables
430434
search_order: ['dbt', 'dbt_external_tables']
431435
```
432-
* To define `STOREDAS` and `ROWFORMAT` for in dbt-external tables, one of the below options can be used:
433-
* user can use the standard dbt-external-tables config `file_format` and `row_format` respectively
434-
* Or user can just add it in `USING` config as mentioned in the Teradata's [documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Table-Statements/CREATE-FOREIGN-TABLE/CREATE-FOREIGN-TABLE-Syntax-Elements/USING-Clause)
435436

436-
* For external source, which requires authentication, user needs to create authentication object and pass it in `tbl_properties` as `EXTERNAL SECURITY` object.
437-
For more information on Authentication object please follow this [link](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Authorization-Statements-for-External-Routines/CREATE-AUTHORIZATION-and-REPLACE-AUTHORIZATION)
437+
To define `STOREDAS` and `ROWFORMAT` for external tables, one of the following options can be used:
438+
- You can use the standard dbt-external-tables config `file_format` and `row_format` respectively.
439+
- Or you can add it in the `USING` config as mentioned in the [Teradata documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Table-Statements/CREATE-FOREIGN-TABLE/CREATE-FOREIGN-TABLE-Syntax-Elements/USING-Clause).
440+
441+
For the external sources, which require authentication, you need to create an authentication object and pass it in `tbl_properties` as `EXTERNAL SECURITY` object. For more information on authentication objects, check out the [Teradata documentation](https://docs.teradata.com/r/Enterprise_IntelliFlex_VMware/SQL-Data-Definition-Language-Syntax-and-Examples/Authorization-Statements-for-External-Routines/CREATE-AUTHORIZATION-and-REPLACE-AUTHORIZATION).
442+
443+
The following are examples of external sources configured for Teradata:
438444

439-
* Sample external sources are provided below as references
440445
```yaml
441446
version: 2
442447
sources:
@@ -492,10 +497,10 @@ sources:
492497
data_type: CHAR(1)
493498
```
494499

495-
## Fallback Schema
496-
dbt-teradata internally created temporary tables to fetch the metadata of views for manifest and catalog creation. In case if user does not have permission to create tables on the schema they are working on, they can define a fallback_schema(to which they have proper create/drop privileges) in dbt_project.yml as variable.
500+
### Fallback Schema
501+
The dbt-teradata adapter internally creates temporary tables to fetch the metadata of views for manifest and catalog creation. In cases you don't have permission to create tables on the schema you are working on, you can define a fallback_schema (to which you have the proper `create`/`drop` privileges) in the dbt_project.yml as a variable.
497502

498503
```yaml
499504
vars:
500505
fallback_schema: <schema-name>
501-
```
506+
```

0 commit comments

Comments
 (0)