ALTER CATALOG INTEGRATION

Modifie les propriétés d’une intégration de catalogue existante.

Voir aussi :

CREATE CATALOG INTEGRATION , DESCRIBE CATALOG INTEGRATION, DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS

Syntaxe

ALTER CATALOG INTEGRATION [ IF EXISTS ] <name> SET
  REST_AUTHENTICATION = (
    restAuthenticationParams
  )
  [ REFRESH_INTERVAL_SECONDS = <value> ]
  [ COMMENT = '<string_literal>' ]
Copy

Les restAuthenticationParams sont les suivants, en fonction de votre méthode d’authentification :

OAuth

restAuthenticationParams (for OAuth) ::=

  OAUTH_CLIENT_SECRET = '<oauth_client_secret>'
Copy

Jeton du porteur

restAuthenticationParams (for Bearer token) ::=

  BEARER_TOKEN = '<bearer_token>'
Copy

Paramètres

name

Indique l’identificateur de l’intégration de catalogue à modifier.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

SET ...

Définit des propriétés ou des paramètres spécifiés pour définir l’intégration du catalogue :

REFRESH_INTERVAL_SECONDS = value

Spécifie le nombre de secondes pendant lesquelles Snowflake attend entre les tentatives d’interrogation du catalogue Iceberg externe pour que les mises à jour des métadonnées soient actualisées automatiquement.

Pour les tables basées sur le Delta, spécifie le nombre de secondes que Snowflake attend entre les tentatives d’interrogation de votre stockage Cloud externe pour de nouvelles métadonnées.

Valeurs : 30 à 86 400, inclus

Par défaut : 30 secondes

COMMENT = 'string_literal'

Chaîne (littéral) qui spécifie un commentaire pour l’intégration.

Par défaut : aucune valeur

Paramètres d’authentification REST (restAuthenticationParams)

OAuth

OAUTH_CLIENT_SECRET = oauth_client_secret

Votre secret client OAuth2.

Jeton du porteur

BEARER_TOKEN = bearer_token

Le jeton du porteur de votre fournisseur d’identité. Vous pouvez également spécifier un jeton d’accès personnel (PAT).

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

Remarques

OWNERSHIP

Intégration (catalogue)

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).

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation

  • Concernant les métadonnées :

    Attention

    Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples

L’exemple suivant met à jour l’intervalle d’actualisation pour l’actualisation automatique à 30 secondes :

ALTER CATALOG INTEGRATION myCatalogIntegration SET REFRESH_INTERVAL_SECONDS = 30;
Copy
Langage: Français