destinations.sql_jobs

SqlFollowupJob Objects

class SqlFollowupJob(FollowupJobRequestImpl)

[view_source]

Sql base job for jobs that rely on the whole tablechain

from_table_chain

@classmethod
def from_table_chain(
        cls,
        table_chain: Sequence[PreparedTableSchema],
        sql_client: SqlClientBase[Any],
        params: Optional[SqlJobParams] = None) -> FollowupJobRequestImpl

[view_source]

Generates a list of sql statements, that will be executed by the sql client when the job is executed in the loader.

The table_chain contains a list of schemas of nested tables, ordered by the ancestry (the root of the tree is first on the list).

SqlStagingCopyFollowupJob Objects

class SqlStagingCopyFollowupJob(SqlFollowupJob)

[view_source]

Generates a list of sql statements that copy the data from staging dataset into destination dataset.

SqlMergeFollowupJob Objects

class SqlMergeFollowupJob(SqlFollowupJob)

[view_source]

Generates a list of sql statements that merge the data from staging dataset into destination dataset. If no merge keys are discovered, falls back to append.

gen_key_table_clauses

@classmethod
def gen_key_table_clauses(cls, root_table_name: str,
                          staging_root_table_name: str,
                          key_clauses: Sequence[str],
                          for_delete: bool) -> List[str]

[view_source]

Generate sql clauses that may be used to select or delete rows in root table of destination dataset

A list of clauses may be returned for engines that do not support OR in subqueries. Like BigQuery

gen_delete_temp_table_sql

@classmethod
def gen_delete_temp_table_sql(
        cls, table_name: str, unique_column: str,
        key_table_clauses: Sequence[str],
        sql_client: SqlClientBase[Any]) -> Tuple[List[str], str]

[view_source]

Generate sql that creates delete temp table and inserts unique_column from root table for all records to delete. May return several statements.

Returns temp table name for cases where special names are required like SQLServer.

gen_select_from_dedup_sql

@classmethod
def gen_select_from_dedup_sql(cls,
                              table_name: str,
                              primary_keys: Sequence[str],
                              columns: Sequence[str],
                              dedup_sort: Tuple[str, TSortOrder] = None,
                              condition: str = None,
                              condition_columns: Sequence[str] = None) -> str

[view_source]

Returns SELECT FROM SQL statement.

The FROM clause in the SQL statement represents a deduplicated version of the table_name table.

Expects column names provided in arguments to be escaped identifiers.

Arguments:

• table_name - Name of the table that is selected from.
• primary_keys - A sequence of column names representing the primary key of the table. Is used to deduplicate the table.
• columns - Sequence of column names that will be selected from the table.
• sort_column - Name of a column to sort the records by within a primary key. Values in the column are sorted in descending order, so the record with the highest value in sort_column remains after deduplication. No sorting is done if a None value is provided, leading to arbitrary deduplication.
• condition - String used as a WHERE clause in the SQL statement to filter records. The name of any column that is used in the condition but is not part of columns must be provided in the condition_columns argument. No filtering is done (aside from the deduplication) if a None value is provided.
• condition_columns - Sequence of names of columns used in the condition argument. These column names will be selected in the inner subquery to make them accessible to the outer WHERE clause. This argument should only be used in combination with the condition argument.

Returns:

A string representing a SELECT FROM SQL statement where the FROM clause represents a deduplicated version of the table_name table.

The returned value is used in two ways: 1) To select the values for an INSERT INTO statement. 2) To select the values for a temporary table used for inserts.

gen_delete_from_sql

@classmethod
def gen_delete_from_sql(cls, table_name: str, unique_column: str,
                        delete_temp_table_name: str,
                        temp_table_column: str) -> str

[view_source]

Generate DELETE FROM statement deleting the records found in the deletes temp table.

requires_temp_table_for_delete

@classmethod
def requires_temp_table_for_delete(cls) -> bool

[view_source]

Whether a temporary table is required to delete records.

Must be True for destinations that don't support correlated subqueries.

gen_merge_sql

@classmethod
def gen_merge_sql(cls, table_chain: Sequence[PreparedTableSchema],
                  sql_client: SqlClientBase[Any]) -> List[str]

[view_source]

Generates a list of sql statements that merge the data in staging dataset with the data in destination dataset.

The table_chain contains a list schemas of a tables with row_key - parent_key nested reference, ordered by the ancestry (the root of the tree is first on the list). The root table is merged using primary_key and merge_key hints which can be compound and be both specified. In that case the OR clause is generated. The nested tables are merged based on propagated root_key which is a type of foreign key but always leading to a root table.

First we store the root_keys of root table elements to be deleted in the temp table. Then we use the temp table to delete records from root and all netsed tables in the destination dataset. At the end we copy the data from the staging dataset into destination dataset.

If a hard_delete column is specified, records flagged as deleted will be excluded from the copy into the destination dataset. If a dedup_sort column is specified in conjunction with a primary key, records will be sorted before deduplication, so the "latest" record remains.

gen_scd2_sql

@classmethod
def gen_scd2_sql(cls, table_chain: Sequence[PreparedTableSchema],
                 sql_client: SqlClientBase[Any]) -> List[str]

[view_source]

Generates SQL statements for the scd2 merge strategy.

The root table can be inserted into and updated. Updates only take place when a record retires (because there is a new version or it is deleted) and only affect the "valid to" column. Nested tables are insert-only.