Modifies the properties of an existing catalog integration.
CREATE CATALOG INTEGRATION , DESCRIBE CATALOG INTEGRATION, DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS
ALTER CATALOG INTEGRATION [ IF EXISTS ] <name> SET REST_AUTHENTICATION = ( restAuthenticationParams ) [ REFRESH_INTERVAL_SECONDS = <value> ] [ COMMENT = '<string_literal>' ]
Copy
The restAuthenticationParams
are as follows, depending on your authentication method:
OAuth
restAuthenticationParams (for OAuth) ::= OAUTH_CLIENT_SECRET = '<oauth_client_secret>'
Copy
Bearer token
restAuthenticationParams (for Bearer token) ::= BEARER_TOKEN = '<bearer_token>'
Copy
Parameters¶name
Specifies the identifier for the catalog integration to alter.
If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
For more information, see Identifier requirements.
SET ...
Sets one or more specified properties or parameters to set for the catalog integration:
REFRESH_INTERVAL_SECONDS = value
Specifies the number of seconds that Snowflake waits between attempts to poll the external Iceberg catalog for metadata updates for automated refresh.
For Delta-based tables, specifies the number of seconds that Snowflake waits between attempts to poll your external cloud storage for new metadata.
Values: 30 to 86400, inclusive
Default: 30 seconds
COMMENT = 'string_literal'
String (literal) that specifies a comment for the integration.
Default: No value
OAuth
OAUTH_CLIENT_SECRET = oauth_client_secret
Your OAuth2 client secret.
Bearer token
Access control requirements¶
BEARER_TOKEN = bearer_token
The bearer token for your identity provider. You can alternatively specify a personal access token (PAT).
A role used to execute this operation must have the following privileges at a minimum:
Privilege
Object
Notes
OWNERSHIP
Integration (catalog)
OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).
For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.
For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.
Usage notes¶Regarding metadata:
Attention
Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Metadata fields in Snowflake.
The following example updates the refresh interval for automated refresh to 30 seconds:
ALTER CATALOG INTEGRATION myCatalogIntegration SET REFRESH_INTERVAL_SECONDS = 30;
Copy
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4