Using the Google Drive Destination Component
The Google Drive Destination Component is an SSIS data flow pipeline component that can be used to write data to Google Drive. There are three pages of configuration:
- General
- Columns
- Error Handling
The General page is used to specify general settings for the Google Drive Destination Component. The Columns page allows you to map the columns from upstream components to Google Drive fields in the destination object. The Error Handling page allows you to specify how errors should be handled when they occur.
General Page
The General page allows you to specify general settings for the component.
- Connection Manager
-
The Google Drive Destination Component requires a Google Drive connection. The Connection Manager drop-down will show a list of Google Drive Connection Managers that are available within the package.
- Destination Object
-
The Destination Object drop-down allows you to specify the type of Google Drive object to work with. Available options are:
- Folder
- File
- Action
-
The Action option specifies how you want to write to Google Drive using the selected Connection Manager. Available actions include:
- Create: Creates new record(s).
- Update: Updates an item's metadata and/or content.
- Delete: Deletes record(s).
- Copy: Copies a source file to a destination location. This option is available when File is selected as the Destination Object.
- Empty Trash: Permanently deletes all of the user's trashed files.
- Upload Type
-
The Upload Type option specifies how file content is uploaded to Google Drive. This option is available when File is selected as the Destination Object and the Action is Create or Update. Available options are:
- Simple: Use this upload type to quickly transfer a small media file (5 MB or less).
- Multipart: Use this upload type to quickly transfer a small file (5 MB or less) and metadata that describes the file in a single request.
- Resumable: Use this upload type for large files (greater than 5 MB) in a resumable fashion.
- Overwrite Mode
-
The Overwrite Mode option specifies how the component should handle an item when another item with the same name already exists. This option is available when the Create action is selected. Available options are:
- Overwrite existing item: Replaces the existing item with the item being created.
- Skip when item already exists: Skips the item when an item with the same name already exists.
- Auto increment item name: Increments the number at the end of the item name. If a number does not exist, one is added. The number continues to increment until an item name is found that does not already exist.
- Raise error when item already exists: Raises an error when an item with the same name already exists. The error can be handled using the options on the Error Handling page.
- Refresh Component Button
-
Clicking the Refresh Component button causes the component to retrieve the latest metadata and update each field to its most recent metadata.
- Map Unmapped Fields Button
-
By clicking this button, the component will try to map any unmapped Google Drive fields by matching their names with the input columns from upstream components. This is useful when your source component has recently added more columns, in which case you can use this button to automatically establish the association between input columns and unmapped destination fields.
- Clear All Mappings Button
-
By clicking this button, the component will reset all your mappings in the destination component.
- Expression fx Button
-
Click the fx button to launch the SSIS Expression Editor to enable dynamic updates of the property at run time.
- Generate Documentation Button
-
Click the Generate Documentation button to generate a Word document that describes the component's metadata, including relevant mapping, and so on.
Columns Page
The Columns page of the Google Drive Destination Component allows you to map the columns from upstream components to the Google Drive destination fields.
On the Columns page, you will see a grid that contains four columns as shown below.
The Hide Mapped and Hide Unmapped options can be used to narrow the list of destination fields, and the Filter box can be used to locate a specific field.
- Input Column: You can select an input column from an upstream component for the corresponding Google Drive field.
- Destination Field: The Google Drive field that you are writing data to.
- DataType: This column indicates the type of value for the current field.
- Unmap: This column can be used to unmap the field from the upstream input column, or otherwise it can be used to map the field to an upstream input column by matching its name if the field is not currently mapped.
Error Handling Page
The Error Handling page allows you to specify how errors should be handled when they happen.
There are three options available:
- Fail on error
- Redirect rows to error output
- Ignore error
When the Redirect rows to error output option is selected, rows that failed to write to Google Drive will be redirected to the 'Error Output' output of the Destination Component. As indicated in the screenshot below, the blue output connection represents rows that were successfully written, and the red 'Error Output' connection represents erroneous rows. The 'ErrorMessage' output column found in the 'Error Output' may contain the error message that was reported by the server or the component itself.
- Enable Columns for Default Output
-
NewlyCreatedRecordId: Enable this option to get the ID value for the newly created record in the default output.
Note: Use extra caution when selecting the Ignore error option, since the component will remain silent for any errors that have occurred.