catalog.configure_catalog (SSISDB Database)

Configures the Integration Services catalog by setting a catalog property to a specified value.

Syntax

configure_catalog [ @property_name = ] property_name , [ @property_value = ] property_value

Arguments

• [ @property\_name = ] property_name
  The name of the catalog property. The property_name is nvarchar(255). For more information about available properties, see catalog.catalog_properties (SSISDB Database).

• [ @property\_value = ] property_value
  The value of the catalog property. The property_value is nvarchar(255). For more information about property values, see catalog.catalog_properties (SSISDB Database)

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Remarks

This stored procedure determines whether the property_value is valid for each property_name.

This stored procedure can be performed only when there are no active executions, such as pending, queued, running, and paused executions.

While the catalog is being configured, all other catalog stored procedures fail with the error message “Server is currently being configured”.

When the catalog is configured, an entry is written to the operation log.

Permissions

This stored procedure requires one of the following permissions:

• Membership to the ssis_admin database role

• Membership to the sysadmin server role

Errors and Warnings

The following list describes some conditions that may raise an error or warning:

• The property does not exist

• The property value is invalid