Versions Compared

Key

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

...

Multiexcerpt macro
hiddenfalse
nameFTPS_Prerequisite
fallbackfalse

Connect to FTP server:

To connect to the FTP server that needs to reuse the session for data transfer over TLS protocoladd:

-DFTPS_SSL_TLS_PROTOCOL=TLSV1.2  (or) TLSV1.3property as a JVM option under the Global properties of the Node Properties tab:

...

Field

Field Type

Description

Label*


Default Value: Directory Browser
ExampleDirectory Browser

String

Specify a unique name for the Snap.

Directory 

Default Value: N/A

Examples

  • Read the file from a location of the storage: adl://storename/folder/filename 

  • If the Snap is executed in the Windows Groundplex and needs to access D: drive): file:///D:/testFolder/ 

  • ftp://ftp.mock.com/vehicles

  • If the bucket name is 'testBucket': gs:///testBucket/testDir/ 

  • project-name

  • s3:///<S3_bucket_name>@s3.<region_name>.amazonaws.com/<path>

  • File in VPC: s3:///snaplogic-bucket@bucket.vpce-0e340d8d5b0eae90a-k9wbom46-us-west-2a.s3.us-west2.vpce.amazonaws.com

  • sftp://sftp.mock.com/students/grades/

  • share

  • sldb:///shared

  • sldb:///project-name

  • If the target folder is /share/folder in server: smb://server/share/folder/ 

  • If the name of the container is 'Snaplogic': wasb:///Snaplogic/testDir/
    or wasbs:///Snaplogic/testDir/ 

String/Expression

Specify the URL for the data source (directory) that should begin with a protocol. Following are the protocols that are currently supported:

  • sldb:

  • s3:

  • ftp:

  • ftps:

  • sftp:

  • hdfs:

  • wasb:

  • wasbs:

  • smb:

  • gs:

  • adl:

  • file:

File filter

Default Value: N/A
Example:

  • *.txt

  • ab????xx.*x

  • *.[jJ][sS][oO][nN]

String/Expression

Specify the Glob pattern for filtering the files. The Glob pattern can be applied to select the contents (files/sub-folders) of the directory. You cannot recursively navigate through the directory structures.

Ignore empty result

Default Value: Selected

Checkbox

Select this checkbox to enable the Snap to not write a document to the output view when the result is empty.

Deselect this checkbox in the following cases:

  • If the Snap receives an input document, the input document is passed through to the output view.

  • If the Snap does not receive an input document, an empty document is written to the output view.

Display update time and owner for S3 subdirectories


Default Value: Selected

Checkbox

Applicable only for S3 directory.

If selected, the Snap produces Update time and Owner attributes in the output documents for S3 subdirectories. However, it may take a long time or even freeze if there are very large number of files and subdirectories in the file structure under the specified S3 directory. This is because the Snap has to completely examine the S3 objects under the directory recursively in order to get Update time and Owner attributes for subdirectories.

If not selected, the Snap does not produce Update time and Owner attributes in the output documents for S3 subdirectories. Snap output is faster since it examines only S3 files and subdirectories immediately under the specified S3 directory.

Number of retries


Default Value: 0
Example:  3

String/Expression

Specify the maximum number of retry attempts in case of a network failure.

Minimum value: 0

Retry interval (seconds)


Default Value:1
Example: 3

String/Expression

Specify the minimum number of seconds the Snap must wait before attempting recovery from a network failure.

Minimum value: 1

Advanced properties

Use this field set to define specific settings for directory browsing. 

Properties

SAS URI

Dropdown list



Multiexcerpt macro
nameSASURI_Description_NoAccountSAS

Specify the URI of the Shared Access Storage (SAS) you need to access. You can generate the SAS URI either from the  Snap or from the Azure portal → Shared access signature.

The supported SAS types are:

  • Service SAS on a container
  • Service SAS on blob
  • Ensure that the URI is specified in the format described here.
  • If you provide SAS URI in this field, then:
    • the Primary access key given in the account settings is overridden while authentication. If you do not provide the SAS URI, the Snap considers the Primary access key in the account settings.
    • only this URL is used and the Snap ignores the SAS URI settings that you have configured in the associated account.


Default value
: N/A

Example: https://myaccount.blob.core.windows.net/sascontainer/sasblob.txt?sv=2015-04-05&st=2015-04-
29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60
-168.1.5.70&spr=https&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D


Use fast file-type check for wasb/wasbs protocols

String/Expression


Multiexcerpt macro
nameFast_File_Type_Check_Desc

Specifies whether the Snap can use a fast file-type check while browsing through a given file/directory path (for WASB and WASBS file protocols).

Set this field of the Snap to true to save execution times when working with WASB and WASBS file protocols.

Default value: N/A

Snap execution results may not be accurate when using this field. Set this field to true if longer execution times are not a constraint.




Snap Execution


Default ValueValidate & Execute
Example: Execute only


Dropdown list

Select one of the three modes in which the Snap executes. Available options are:

  • 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 execution without generating preview data.

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

...