ALTER CONNECTION

Modifie les propriétés d’une connexion existante.

Voir aussi :

CREATE CONNECTION , DROP CONNECTION , SHOW CONNECTIONS

Syntaxe

ALTER CONNECTION <name> ENABLE FAILOVER TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ]
                        [ IGNORE EDITION CHECK ]

ALTER CONNECTION <name> DISABLE FAILOVER [ TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] ]

ALTER CONNECTION <name> PRIMARY

ALTER CONNECTION [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER CONNECTION [ IF EXISTS ] <name> UNSET COMMENT
Copy

Paramètres

name

Identificateur de la connexion à modifier.

ENABLE FAILOVER TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ]

Spécifie une liste de comptes de votre entreprise séparés par des virgules où une connexion secondaire à cette base de données primaire peut être promue pour servir de base de données primaire. Incluez le nom de votre organisation pour chaque compte de la liste.

Chaque compte de la liste doit être situé dans une région différente de celle du compte avec la connexion primaire. Sinon, la commande échoue.

DISABLE FAILOVER [ TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ] ]

Désactive le basculement pour cette connexion primaire, ce qui signifie qu’aucune connexion secondaire pour cette connexion primaire ne peut être promue pour servir de connexion primaire.

Pour désactiver le basculement sur des comptes sélectionnés (plutôt que sur tous les comptes), spécifiez une liste de ces comptes séparés par des virgules.

PRIMARY

Promouvez la connexion pour servir de connexion primaire.

SET ...

Spécifie les propriétés à définir pour la connexion :

COMMENT = 'string'

Ajoute un commentaire ou écrase un commentaire existant pour la connexion.

UNSET ...

Spécifie les propriétés à désactiver pour la connexion, qui les réinitialise aux valeurs par défaut.

Actuellement, la seule propriété que vous pouvez désactiver est COMMENT, ce qui supprime le commentaire, s’il existe, pour la connexion.

Notes sur l’utilisation

  • Seuls les administrateurs de compte (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent exécuter cette commande SQL.

  • Si une connectivité privée au service Snowflake est activée pour votre compte Snowflake, votre administrateur réseau doit mettre à jour l’enregistrement CNAME DNS de votre URL de connexion lorsqu’une connexion est promue au rang de connexion principale. Pour plus d’informations, voir Configuration des paramètres DNS pour la connectivité privée au service Snowflake.

  • 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

Autorisez les comptes myaccount2 et myaccount3 de l’organisation myorg à stocker chacun une connexion secondaire pour la connexion myconnection :

ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;
Copy

Ajoutez un commentaire pour une connexion :

ALTER CONNECTION myconnection SET COMMENT = 'New comment for connection';
Copy

Promouvez une connexion secondaire à la connexion primaire :

ALTER CONNECTION myconnection PRIMARY;
Copy