You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/docs/reference/resource-configs/teradata-configs.md
+19-14Lines changed: 19 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -414,29 +414,34 @@ These steps collectively ensure that the valid_history strategy effectively mana
414
414
```
415
415
See [Collecting Statistics documentation](https://docs.teradata.com/r/76g1CuvvQlYBjb2WPIuk3g/RAyUdGfvREwbO9J0DMNpLw) for more information.
416
416
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
+
421
423
```yaml
422
424
packages:
423
425
- package: dbt-labs/dbt_external_tables
424
426
version: [">=0.9.0", "<1.0.0"]
425
427
```
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
+
427
431
```yaml
428
432
dispatch:
429
433
- macro_namespace: dbt_external_tables
430
434
search_order: ['dbt', 'dbt_external_tables']
431
435
```
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)
435
436
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:
438
444
439
-
* Sample external sources are provided below as references
440
445
```yaml
441
446
version: 2
442
447
sources:
@@ -492,10 +497,10 @@ sources:
492
497
data_type: CHAR(1)
493
498
```
494
499
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.
0 commit comments