In this article
Overview
You can use this Snap to bulk load data into AlloyDB tables. If the target table does not exist in AlloyDB, you can create a table. This Snap supports both binary and document inputs. You can configure the input view in the Views tab.
Snap Type
The AlloyDB Bulk Load Snap is a Write-type Snap.
Prerequisites
None.
Support for Ultra Pipelines
Does not support Ultra Pipelines.
Limitations
If the target table does not exist and the input is binary, the Snap does not fetch the table's schema from the input. The table's schema must be passed to the Snap through the second input view.
Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input |
|
|
| 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 |
|
| 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:
Learn more about Error handling in Pipelines. |
Snap Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon ( ): Indicates that you can add fields in the fieldset.
Remove icon ( ): Indicates that you can remove fields from the fieldset.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Description | |
---|---|---|---|
Label* Default Value: AlloyDB Bulk Load | String | Specify a unique name for the Snap. | |
Schema Default Value: N/A | 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*
| String/Expression | Specify the AlloyDB table on which to run the bulk load operation. | |
Create table if not present
| Checkbox | Select this checkbox to automatically create the target table if it does not exist.
A newly created table is not visible to subsequent database Snaps during runtime validation. If you want to immediately use the newly updated data you must use a child Pipeline that is invoked through a Pipeline Execute Snap. | |
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
| 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
| 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
| 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*
| Dropdown list | Choose the data format to be written. This field is applicable only when using the binary input view.
| |
Header Provided
| 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 | 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: | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Snap Pack History
Release | Snap Pack Version | Date | Type | Updates |
---|---|---|---|---|
May 2024 | 4postgresupgrade26570 |
| - | The JDBC driver for the Google AlloyDB Snap Pack has been upgraded from v42.4.2 to v42.7.2 (Java 8). This upgrade will be part of the GA release on August 14, 2024 (Stable release). As part of this upgrade, the 42.7.2 JDBC driver is bundled with the AlloyDB Snap Pack as the default JDBC driver. Learn more about the behavior changes caused by the driver upgrade. |
May 2024 | main26341 |
| Stable | Updated the Delete Condition (Truncates a Table if empty) field in the AlloyDB Delete Snap to Delete condition (deletes all records from a table if left blank) to indicate that all entries will be deleted from the table when this field is blank, but no truncate operation is performed. |
February 2024 | main25112 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
November 2023 | main23721 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
August 2023 | main22460 |
| Stable | The AlloyDB Execute Snap now includes a new Query type field. When Auto is selected, the Snap tries to determine the query type automatically. |
May 2023 | main21015 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
February 2023 | main19844 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
November 2022 | main18944 |
| Stable | The AlloyDB Insert Snap now creates the target table only from the table metadata of the second input view when the following conditions are met:
|
September 2022 | 430patches18149 |
| Latest | The AlloyDB Select and AlloyDB Execute Snaps now read NaN values in Numeric columns. |
4.30Patches | 430patches17841 |
| Latest | Introduced the Google AlloyDB Snap Pack— a fully managed PostgresSQL-compatible database service that you can use for all your database workloads. This Snap Pack offers the following Snaps: |