Versions Compared

Old Version 49

changes.mady.by.user Shilpa

Saved on

compared with

New Version 50

changes.mady.by.user Anand Vedam

Saved on

Key

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

...

  • When your Databricks Lakehouse Platform instance uses Databricks Runtime Version 8.4 or lower, ELT operations involving large amounts of data might fail due to the smaller memory capacity of 536870912 bytes (512MB) allocated by default. This issue does not occur if you are using Databricks Runtime Version 9.0.
  • ELT Pipelines created prior to 4.24 GA release using one or more of the ELT Insert-Select, ELT Merge Into, ELT Load, and ELT Execute Snaps may fail to show expected preview data due to a common change made across the Snap Pack for the 4.26 GA release. In such a scenario, replace the Snap in your Pipeline with the same Snap from the Asset Palette and configure the Snap's Settings again.
  • In case you are writing into a Snowflake target table, this Snap attempts to create the target table even when it exists in the database.
  • Suggestions displayed for the Schema Name field in this Snap are from all databases that the Snap account user can access, instead of the specific database selected in the Snap's account or Settings.

...

Info
titleSQL Functions and Expressions for ELT

You can use the SQL Expressions and Functions supported for ELT to define your Snap or Account settings with the Expression symbol = enabled, where available. This list is common to all target CDWs supported. You can also use other expressions/functions that your target CDW supports.

...

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
ELT Insert-SelectInsert Employee Records
Get preview dataCheckbox

Multiexcerpt include macro
namegetpreviewdata
pageELT Intersect

Not selectedSelected
Database NameString

Required. Enter the name of the database in which the target table is located. Leave it blank to use the database name specified in the account settings.

If your target database is Databricks Lakehouse Platform (DLP), you can, alternatively, mention the file format type for your table path in this field. For example, DELTA, CSV, JSON, ORC, AVRO. See Table Path Management for DLP section below to understand the Snap's behavior towards table paths.

N/A TESTDB
Schema Name (Not applicable to Databricks Lakehouse Platform)String

Required. Enter the name of the database schema. In case it is not defined, then the suggestion for the schema name retrieves all schema names in the specified database when you click Image Modified.

Multiexcerpt macro
nameME_Schema_Name


  • Ensure that you include the exactly same schema name including the double quotes, if used, when you repeat the schema name in the Target Table Name field.
  • Leave this field blank if your target database is Databricks Lakehouse Platform.



N/A"TEST_DATA"
Target Table NameString

Required. The name of the table or view into which you want to insert the data. 

Info

Only views that can be updated (have new rows) are listed as suggestions. So, Join views are not included. This also implies that the Snap account user has the Insert privileges on the views listed as suggestions.

If your target database is Databricks Lakehouse Platform (DLP), you can, alternatively, mention the target table path in this field. Enclose the DBFS table path between two `(backtick/backquote) characters. For example, `/mnt/elt/mytabletarget`. Learn more about the Snap’s behavior toward paths in theTable Path Management for DLP section.

Note

If you choose to include the schema name as part of the target table name, ensure that it is the same as specified in the Schema Name field, including the double quotes. For example, if the schema name specified is "table_schema_1", then the table name should be "table_schema_1"."tablename".


Note

If the target table or view does not exist during run-time, the Snap creates one with the name that you specify in this field and writes the data into it. During Pipeline validation, the Snap creates the new table or view but does not write any records into it.

  • The new table or view will not be dropped if a subsequent/downstream Snap failure occurs during validation.

  • Use double quotes (““) to specify the table or view name if you want to include special characters such as hyphens (-) in the table or view name.

  • A table or view name must always start with a letter.

  • Integers and underscores (_) can also be a part of the name.

  • All characters are automatically converted to uppercase at the backend. Use double-quotes to retainlowercase.


Multiexcerpt macro
nameME_Schema_And_Table_Names


  • Ensure that you include the exactly same schema name, if at all, including the double quotes as specified in the Schema Name field.



N/A

"TEST_DATA"."DIRECT"

EMPLOYEE_DATA

EMPLOYEE_123_DATA

REVENUE"-"OUTLET

"net_revenue"

Advanced OptionsCheckbox Select this checkbox to define the mapping of your source and target table columns scenario with or without the Insert Expressions list. When selected, it activates the Operation Types field.DeselectedSelected
Operation TypesDropdown list

Choose one of the following options that best describes your source data and the INSERT preference:

  • Source Columns Order. Use this operation type to fill the target table columns with the source table data in the same order of columns as in the source table.
  • Some Source and Target Column names are identical. Use this operation type when you want only a subset of the target table columns that are identical to the source to be filled with the source data and optionally define the Insert Expression List to fill the remaining columns in the target table.
  • All Source and Target Column names are identical. Use this operation type when your source and target table have the same set of column names. You cannot specify any Insert Expressions with this operation type.
Source Columns OrderSome Source and Target Column names are identical
Table Option List

This field set enables you to specify the table options you want to use on the target table. These options are populated based on the Snap Account (target CDW) selected. You must specify each table option in a separate row. Click  to add rows. 

This field set contains one field:

  • Table Option
Table OptionString/Suggestion

Click the Suggestions icon (  ) to view and select the table option you want to apply for loading data into the target table.

N/ADISTRIBUTION = HASH ( cust_name )
Insert Expression List

This field set enables you to specify the values for a subset of the columns in the target table. The remaining columns are assigned null values automatically. You must specify each column in a separate row. Click  to add rows. 

This field set is disabled if you select All Source and Target Column names are identical in the Operation Types field.

This field set consists of the following fields:

  • Insert Column
  • Insert Value
Note

You can use this field set to insert data only into an existing table. 


Insert ColumnStringEnter the name of the column in the target table to assign values.N/AORD_AMOUNT
Insert ValueStringEnter the value to assign in the specified column. Repeat the column name if you want to use the values in the source table. You can also use expressions to transform the values.N/A

ORD_AMOUNT

ORD_AMOUNT+20

OverwriteCheckboxSelect to overwrite the data in the target table. If not selected, the incoming data is appended. Not selectedSelected

Snap behavior in different source and target table column scenarios


Data match (operation) type 
Number of source
table columns 
Number of target
table columns 
Insert expression
list specified? 
Snap behavior
Not specified (Advanced Options checkbox is not selected)LessMoreYes
  • Ignores data in the source table columns.
  • Inserts values from the Expression list in the target table columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if the target table does not exist.
Not specified (Advanced Options checkbox is not selected)SameSameYes
  • Ignores data in the source table columns.
  • Inserts values from the Expression list in the target table columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if the target table does not exist.
Not specified (Advanced Options checkbox is not selected)MoreLessYes
  • Ignores data in the source table columns.
  • Inserts values from the Expression list in the target table columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if the target table does not exist.
Not specified (Advanced Options checkbox is not selected)LessMoreNo
  • Inserts values into the target table columns that match the source columns.
  • Inserts nulls in the remaining target columns.
Not specified (Advanced Options checkbox is not selected)SameSameNo
  • Inserts values into the target table columns that match the source columns.
  • Replicates the source table as a new target table, if the target table does not exist.
Not specified (Advanced Options checkbox is not selected)MoreLessNo
  • Inserts values into the target table columns that match the source columns.
  • Inserts nulls in the remaining target table columns.
  • Replicates the source table as a new target table, if the target table does not exist.
Source Columns OrderLessMoreNo
  • Inserts values from the source in the matching target columns.
  • Inserts nulls in the remaining target columns.
Source Columns OrderLessMoreYes
  • Inserts values from the source in the matching target columns.
  • Inserts values from the Insert expression list in the specified target columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if any specified column name is not found in the target table.
Source Columns OrderSameSameNo
  • Inserts values from the source in the matching target columns.
Source Columns OrderSameSameYes
  • Returns an error that the source table (combined with Insert Expression list) has more columns than the target table.
All Source and Target Column names are identicalLessMoreNot displayed
  • Inserts values from the source in the matching target columns.
  • Inserts nulls in the remaining target columns.
All Source and Target Column names are identicalSameSameNot displayed
  • Inserts values from the source in the matching target columns.
  • Inserts nulls in the remaining target columns.
Some Source and Target Column names are identicalLessMoreNo
  • Inserts values from the source in the matching target columns.
  • Inserts nulls in the remaining target columns.
Some Source and Target Column names are identicalLessMoreYes
  • Assumes that there is no column name in common between the source table and Insert expression list. Returns an error if a common column is found.
  • Inserts values from the source in the matching target columns.
  • Inserts values from the Insert Expression list in the specified target columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if any specified column name is not found in the target table.
Some Source and Target Column names are identicalSameSameNo
  • Inserts values from the source in the matching target columns.
  • Inserts nulls in the remaining target columns.
Some Source and Target Column names are identicalSameSameYes
  • Assumes that the sum of the source table columns count and the Insert Expression list is not more than the target table columns count. Returns an error if this condition is not satisfied.
  • Inserts values from the source in the matching target columns.
  • Inserts values from the Insert expression list in the specified target columns.
  • Inserts nulls in the remaining target columns.
  • Returns an error if any specified column name is not found in the target table.
Any of the three optionsMore LessYes or No
  • Returns an error that the source table (plus Insert expressions) has more columns than the target table and the Insert Select operation cannot be performed.


Table Path Management for DLP

...