Catégories :

Base de données, schéma et partage DDL

CREATE SHARE

Crée un nouveau :emph:`` partage vide. Une fois le partage créé, vous pouvez inclure une base de données et des objets de la base de données (schémas, tables et vues) dans le partage en utilisant la commande GRANT <privilège> … TO SHARE. Vous pouvez alors utiliser ALTER SHARE pour ajouter un ou plusieurs comptes au partage.

Voir aussi :

DROP SHARE , ALTER SHARE , SHOW SHARES , DESCRIBE SHARE

Syntaxe

CREATE [ OR REPLACE ] SHARE <name>
  [ COMMENT = '<string_literal>' ]

Paramètres requis

name

Indique l’identificateur du partage ; doit être unique pour le compte dans lequel le partage est créé.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (p. ex. "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus de détails, voir Exigences relatives à l’identificateur.

Paramètres facultatifs

COMMENT = 'string_literal'

Spécifie un commentaire pour le partage.

Par défaut : aucune valeur

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

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège

Objet

Remarques

CREATE SHARE

Compte

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

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 Contrôle d’accès dans Snowflake.

Pour plus d’informations spécifiques sur les exigences en matière de contrôle d’accès pour Snowflake Secure Data Sharing, voir Capacité des rôles non ACCOUNTADMIN à effectuer des tâches de partage de données.

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.

  • Les instructions CREATE OR REPLACE <objet> sont atomiques. Autrement dit, lorsque l’objet est remplacé, la suppression de l’ancien objet et la création du nouvel objet sont traitées en une seule transaction.

Exemples

Créer un partage vide nommé sales_s :

CREATE SHARE sales_s;

+-----------------------------------------+
| status                                  |
|-----------------------------------------|
| Share SALES_S successfully created.     |
+-----------------------------------------+

Après cette étape, pour terminer le partage, vous devez :

  1. Utiliser la commande GRANT <privilège> … TO SHARE pour ajouter une base de données (et des objets dans la base de données) au partage.

  2. Utiliser la commande ALTER SHARE pour ajouter des comptes au partage.

Revenir au début