Input 

• Document

• Binary

• Min: 1

• Max: 2

• Mapper Snap

• Copy Snap

• File Reader

• AlloyDB Select

The data to be loaded into the AlloyDB table. This Snap has one document input view by default.

A second view can be added for table metadata as a binary or document stream so that the target absent table can be created in the database with a schema similar to the source table. This schema is usually from the output of a database Select Snap.

Output

Document

• Min: 0

• Max: 1

• JSON Formatter

• File writer

The Snap outputs one document specifying the status, with the records count that are being inserted into the table. Any error occurring during the process is routed to the error view.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

• Stop Pipeline Execution: Stops the current Pipeline execution if the Snap encounters an error.

• Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

• Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Label*

Default Value: AlloyDB Bulk Load
Example: Load Employee Data

String

Specify a unique name for the Snap.

Schema

Default Value: N/A
Example: Employee 

String/Expression

Specify the database schema name in AlloyDB. If you do not specify a schema, then the suggestion for the Table name retrieves all table names of all schemas.

Table name*

Default Value: N/A
Example: Employee.PersonnelInformation

Specify the AlloyDB table on which to run the bulk load operation.

Create table if not present

Default Value: Deselected

Checkbox

Select this checkbox to automatically create the target table if it does not exist.

• If a second input view is configured for the Snap and it contains a document with schema (metadata) of the source table, the Snap creates the new (target) table using the same schema (metadata). However, if the schema comes from a different database, the Snap might fail with Unable to create table: "<table_name>" error due to data type incompatibility.

• In the absence of a second input view (the schema/metadata document), the Snap creates a table based on the data types of the columns generated from the first row of the input document (first input view).

Columns

Use this field set to define the columns to be loaded/copied. If you do not configure this field set, then all columns in the input data stream are loaded into the target table. You can also set how you want the Snap to handle null values for each column.

Column

Default Value: N/A
Example: emp_name

String/Expression

Specify the name of the column/field. This is a suggestible field and lists all field names in the input.

Force Not-Null

Default Value: Deselected
Example: N/A

Checkbox

Select this checkbox to not match the selected column's value against the null string. The Snap reads empty null strings as zero-length strings rather than nulls, even when they are not quoted.

Force Null

Default Value: Deselected
Example: N/A

Checkbox

Select this checkbox to match the selected column value against the null string, even if it has been quoted. If a match is found, the field value is set to NULL.

By default, when the null string is empty, the Snap converts a quoted empty string into NULL.

Format*

Default Value: Text
Example: CSV

Dropdown list

Choose the data format to be written. This field is applicable only when using the binary input view. 

• Text - tab-separated-values (default)

• CSV - comma-separated-values

• Binary - AlloyDB specific format

Header Provided

Default Value: Deselected
Example: N/A

Checkbox

Select this checkbox to include the input data as a header. Applicable only when using the binary input view and CSV option in the Format field.

Encoding

Default Value: UTF8
Example: Unicode

Dropdown list

Choose one of the following encodings to use. This is limited to the encodings supported by the AlloyDB server:

Snap Execution

Default Value: 
Example: Validate & Execute

Dropdown list

Select one of the following three modes in which the Snap executes:

• Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

• Execute only: Performs full execution of the Snap during Pipeline runtime without generating preview data.

• Disabled: Disables the Snap and all Snaps that are downstream from it.