Versions Compared

Old Version 39

changes.mady.by.user Amritesh Singh

Saved on

compared with

New Version 40

changes.mady.by.user Amritesh Singh

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this Page

Table of Contents
maxLevel2
absoluteUrltrue
excludeOlder Versions|Additional Resources|Related Links|Related Information

Overview

This Snap provides the functionality of SCD (Slowly Changing Dimension) Type 2 on a target Snowflake table. You can use this Snap to execute one SQL lookup request per set of input documents to avoid making a request for every input record. Its output is typically a stream of documents for the Snowflake - Bulk Upsert Snap, which updates or inserts rows into the target table. Therefore, this Snap must be connected to the Snowflake - Bulk Upsert Snap to accomplish the complete SCD2 functionality.

...

Snap Type

Snowflake SCD2 is a Read-type Snap that enables you to execute multiple queries as a single atomic unit.

...

Works in Ultra Pipelines. However, we recommend that you not use this Snap in an Ultra Pipeline.

Known Issues

Because of performance issues, all Snowflake Snaps now ignore the Cancel queued queries when pipeline is stopped or if it fails option for Manage Queued Queries, even when selected. Snaps behave as though the default Continue to execute queued queries when the Pipeline is stopped or if it fails option were selected.



We plan to address this issue in a patch for the next monthly release in December.

...

Field Name

Field Type

Description

Label*

Default Value: Snowflake - SCD2
Example: Snowflake - SCD2

String

Specify the name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Schema name

Default Value: N/A 
Example: TestSchema

String/Expression

Specify the database schema name. In case it is not defined, then the suggestion for the Table Name will retrieve all tables names of all schemas. The property is suggestible and will retrieve available database schemas during suggest values.

Table Name

Default Value: N/A 
Example: TestTable

String/Expression

Specify the name of the table in the instance. The table name is suggestible and requires an account setting.  

The target table should have the following three columns for field historization to work:

  • Column to demarcate whether a row is a current row or not. For example, "CURRENT_ROW". For the current row, the value would be true or 1. For the historical row, the value would be false or 0.

  • Column to denote the starting date of the current row. For example, "START_DATE".

  • Column to denote when the row was historized. For example, "END_DATE". For the active row, it's null. For a historical row, it has the value that indicates it was effective till that date.

Use the ALTER table command to add these columns to your target table if they are not present. 

Natural key*

Default Value: N/A
Example: id (Each record has to have a unique value)

String/Expression

Specify the names of fields that identify a unique row in the target table. The identity key cannot be used as the Natural key, since a current row and its historical rows cannot have the same natural key value

Cause-historization fields 

Default Value: N/A
Example: gold bullion rate

String/Expression

Specify the names of fields where any change in value causes the historization of an existing row and the insertion of a new current row.

SCD fields

The historical and updated information for the Cause-historization field. Click + to add SCD fields. By default, there are four rows in this field-set:

  • Current row

  • Historical row

  • Start date of the current row

  • End date of historical row.

Meaning*

Default value: 

  • Current row

  • Historical row

  • Start date of current row

  • End date of historical row

Dropdown list

Specifies the table columns that are to be updated for implementing the SCD2 type transformation.

Field*

Default value: N/A
Example: CURRENT_ROW

String/Expression

Specify the fields in the table will contain the historical information. 

Below are the values that must be configured for each row:

  • Current row: The name of the column in the target table that holds the flag for the historized field. For example, "CURRENT_ROW".

  • Historical row: The name of the column in the target table that holds the flag for the historized field. It has to be the same as the value configured for the Current row field. For example, "CURRENT_ROW".

  • Start date of current row: The name of the column in the target table for denoting the start date for the current row. For example, "START_DATE".

  • End date of historical row: The name of the column in the target table for denoting the end date for the historical row. For example, "END_DATE".

By default, the start and end date for both Current row and Historical row are null. After the Snap is executed, the start date for the updated row data automatically becomes the end date for the earlier version of the data (Historical row).

Value*

Default value: 

  • Current row and Historical row: N/A

  • Start date of current row, and End date of historical row: Date.now()

String/Expression

Specify the value to be assigned to the current or historical row. For date-related rows, the default is Date.now(). 

The Value field should be configured as follows:

  • Current row: 1

  • Historical row: 0

Ignore unchanged rows

Default value: Deselected

Checkbox

Specifies whether the Snap must ignore writing unchanged rows from the source table to the target table. If you enable this option, the Snap generates a corresponding document in the target only if the Cause-historization column in the source row is changed. Else, the Snap does not generate any corresponding document in the target. 

Number of Retries

Default Value: 0
Example: 3

Integer/Expression

The number of times that the Snap must try to write the fields in case of an error during processing. An error is displayed if the maximum number of tries has been reached.

Retry Interval (Seconds)

Default Value: 1
Example: 3

Integer/Expression

The time interval, in seconds, between subsequent retry attempts. 

Default value: 1

Auto Historization Query

This field-set is used to specify the fields that are to be used to historize table data. Historization is in the sort order specified. Care must be taken that the field is sortable. You can also add multiple fields here; historizaton occurs when even of the fields is changed. 

Field*

Default Value: N/A
Example: Invoice_Number

String/Expression

Specify the name of the field. This is a suggestible field and suggests all the fields in the target table.

If this field has null values in the incoming records, then the value in the Snowflake table is treated as the current value and the incoming record is historized. 

Sort Order*

Default Value: Ascending Order
Example: Descending Order

Dropdown list

The order in which the selected field is to be historized. Available options are:

  • Ascending Order: The higher value is classified as a current event. For example date of transaction, age, height, etc.

  • Descending Order: The lower value is classified as the current event. For example, rank.

Input Date Format

Default Value: Continue to execute the snap with given input Date format
Example: Auto Convert the format to Snowflake default format

Dropdown list

The property has the following two options:

  • Select Continue to execute the snap with the given input Date format if you want the Snap to continue with the current date format. This option is selected by default. 

  • Select Auto Convert the format to Snowflake default format if you want the Snap to convert the provided date format to the default Snowflake date format. To know about the date formats supported by Snowflake, see Snowflake date formats

Manage Queued Queries

Default Value: Continue to execute queued queries when the Pipeline is stopped or if it fails
Example: Cancel queued queries when the Pipeline is stopped or if it fails

Dropdown list

Select this property to decide whether the Snap should continue or cancel the execution of the queued Snowflake Execute SQL queries when you stop the pipeline.

If you select Cancel queued queries when pipeline is stopped or if it fails, then the read queries under execution are canceled, whereas the write queries under execution are not canceled. Snowflake internally determines which queries are safe to be canceled and cancels those queries.

Multiexcerpt include macro
nameSnap Execution
pageAnaplan Read

Default Value: Validate & Execute
Example: Execute only

Dropdown list

Multiexcerpt include macro
nameSnap_Execution_Introduced
pageAnaplan Read

...

Attachments
patterns*.slp, *.zip, *.csv

Snap Pack History

Expand

Insert excerpt
Snowflake Snap Pack
Snowflake Snap Pack
nameSnowflake_SPH
nopaneltrue