Veeva Bulk Query

Overview

The Veeva Bulk Query Snap retrieves large volumes of data from Veeva Vault using bulk queries.

Use this Snap to efficiently extract large datasets from Veeva Vault when standard queries would exceed resource limits.


Veeva Bulk Query Snap overview

Supported Accounts

Snap views

Type Description Examples of upstream and downstream Snaps
Input

This Snap has at most one document input view.

The input document can provide query parameters. If no input is provided, the Snap uses the configured bulk query.

Output

This Snap has exactly one document output view.

The output document contains the bulk query results from Veeva Vault, potentially spanning multiple batches.

Learn more about Error handling.

Snap settings

Note: Learn about the common controls in the Snap settings dialog.
Field/Field set Description
Label*

String

Specify a unique name for the Snap. Modify this to be more appropriate, especially if more than one of the same Snaps is in the pipeline.

Default value: Veeva Bulk Query

API version*

String/Expression/ Suggestion

The Veeva Vault API version to use for this Snap.

Default value: v25.2

Example: v25.2

Ignore empty result

Checkbox

Select this checkbox to ignore empty results from the query. When selected, the Snap does not write an output document if the query returns no results.

Default value: Not selected

VQL query*

String/Expression

The VQL (Veeva Query Language) query to execute as a bulk query against Veeva Vault. Bulk queries are designed to retrieve large volumes of data efficiently.

Default value: N/A

Example: SELECT id, name__v, status__v FROM product__v WHERE status__v = 'active__v'

Number of retries

Integer

The number of retry attempts for failed API calls. The Snap retries the request if it receives a transient error from Veeva Vault.

Default value: 3

Example: 5

Retry interval (seconds)

Integer

The time interval in seconds between retry attempts.

Default value: 1

Example: 10

Snap execution

Dropdown list
Choose 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.

Default value: Validate & Execute