ALTER SHARE

Modifie les propriétés d’un partage existant :

  • Ajoute ou supprime des comptes de la liste des comptes.

  • Définit une nouvelle liste de comptes avec lesquels la base de données correspondante pour le partage est partagée.

  • Modifie d’autres propriétés. Pour plus de détails sur les paramètres, voir Paramètres.

Voir aussi :

CREATE SHARE , DROP SHARE , DESCRIBE SHARE , SHOW SHARES

Syntaxe

ALTER SHARE [ IF EXISTS ] <name> { ADD | REMOVE } ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name>  ADD ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name> SET { [ ACCOUNTS = <consumer_account> [ , <consumer_account> ... ] ]
                                       [ COMMENT = '<string_literal>' ] }

ALTER SHARE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SHARE <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

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

Paramètres

name

Spécifie l’identifiant du partage à 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.

ADD | REMOVE ACCOUNTS = consumer_account [ , consumer_account , ... ]

Spécifie le nom du ou des comptes à ajouter ou à supprimer de la liste des comptes pour le partage :

  • L’ajout d’un compte à un partage qui était déjà dans la liste n’a aucun effet.

  • La suppression d’un compte qui a déjà importé la base de données partagée annule immédiatement l’accès de ce compte à la base de données. Si le compte est ajouté ultérieurement au partage, le compte doit recréer la base de données avant de pouvoir l’utiliser à nouveau.

  • La suppression d’un compte d’un partage qui ne figurait pas déjà dans la liste des comptes partagés n’a aucun effet.

Ce paramètre s’ajoute à la liste existante des comptes pour le partage (ou s’y retire). Si vous voulez remplacer la liste complète des comptes, utilisez plutôt SET.

SHARE_RESTRICTIONS = { TRUE | FALSE }

FALSE : un compte de consommateur Standard ou Enterprise peut être ajouté à un partage appartenant à un compte de fournisseur Business Critical.

TRUE : un compte de consommateur Standard ou Enterprise ne peut pas être ajouté à un partage appartenant à un compte de fournisseur Business Critical.

Par défaut:

TRUE

Important

Vous devez définir ce paramètre chaque fois que vous ajoutez un nouveau compte de consommateur non Business Critical au partage appartenant à un fournisseur Business Critical. Pour plus d’informations, voir Activation du partage depuis un compte Business Critical vers un compte non Business Critical.

SET...

ACCOUNTS = consumer_account [ , consumer_account ... ]

Spécifie le(s) compte(s) à remplacer par tous les comptes précédents avec lesquels le partage a été partagé. Pour ajouter/supprimer des comptes particuliers de la liste, utilisez ADD | REMOVE à la place.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.

COMMENT = 'string'

Ajoute un commentaire ou remplace un commentaire existant pour le partage.

UNSET ...

Spécifie un(e) ou plusieurs paramètre(s)/propriété(s) à désactiver pour le partage, ce qui les réinitialise à leurs valeurs par défaut :

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Notes sur l’utilisation

  • L’un des privilèges suivants est requis pour modifier un partage :

    • Le privilège OWNERSHIP qui est accordé au rôle qui crée le partage.

    • Le privilège CREATE SHARE. Par défaut, seul le ACCOUNTADMIN a le privilège CREATE SHARE. Le ACCOUNTADMIN peut accorder le privilège à tout autre rôle. Le propriétaire du partage ne peut pas accorder ce privilège.

  • Les mots clés ACCOUNT et ACCOUNTS sont tous deux pris en charge et peuvent être utilisés de manière interchangeable.

  • 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

Ajouter deux comptes au partage existant nommé sales_s :

ALTER SHARE sales_s ADD ACCOUNTS=<orgname.accountname1>,<orgname.accountname2>;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy

Supprimer le compte <orgname.accountname>; de sales_s :

ALTER SHARE sales_s REMOVE ACCOUNT=<orgname.accountname>;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy

Définir un nouveau commentaire pour sales_s :

ALTER SHARE sales_s SET COMMENT='This share contains sales data for 2017';

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy