Catégories :

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

DESCRIBE SHARE

Snowflake logo in black (no text) Le partage de fournisseurs n’est pas activé pour tous les comptes

Le partage de fournisseurs est activé par défaut pour la plupart des comptes, mais pas pour tous.

Si vous rencontrez des erreurs lors du partage de données avec des clients, cela signifie que cette fonctionnalité n’est peut-être pas activée pour votre compte. Pour savoir comment l’activer, veuillez contacter le support Snowflake.

Décrit les objets de données qui sont inclus dans un partage.

DESCRIBE peut être abrégé en DESC.

Voir aussi :

DROP SHARE , ALTER SHARE , CREATE SHARE , SHOW SHARES

Syntaxe

Fournisseurs (partage sortant)

DESC[RIBE] SHARE <name>

Consommateurs (partage entrant)

DESC[RIBE] SHARE <provider_account>.<share_name>

Paramètres

nom

Spécifie l’identificateur du partage sortant à décrire. 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.

compte_fournisseur.nom_partage

Spécifie l’identificateur complet du partage entrant à décrire.

Notes sur l’utilisation

  • Seul le rôle ACCOUNTADMIN a les privilèges suffisants pour décrire un partage. L’exécution de cette commande avec un rôle autre que ACCOUNTADMIN renvoie une erreur.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Sortie

  • La sortie de la commande est différente selon que vous êtes un fournisseur ou un consommateur :

    • Si vous êtes fournisseur, les noms des objets dans le partage sont préfixés avec le nom de la base de données.

    • Si vous êtes consommateur, les noms des objets dans le partage sont préfixés avec un nom de base de données uniquement si une base de données a été créée à partir du partage. Si aucune base de données n’a été créée à partir du partage, les objets sont préfixés avec le préfixe <DB>.

  • La colonne kind de la sortie affiche le type des objets dans le partage.

Exemples

En tant que fournisseur, afficher les objets dans le partage sales_s :

DESC SHARE sales_s;

+----------+--------------------------------------+-------------------------------+
| kind     | name                                 | shared_on                     |
|----------+--------------------------------------+-------------------------------|
| DATABASE | SALES_DB                             | 2017-06-15 17:03:16.642 -0700 |
| SCHEMA   | SALES_DB.AGGREGATES_EULA             | 2017-06-15 17:03:16.790 -0700 |
| TABLE    | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | 2017-06-15 17:03:16.963 -0700 |
+----------+--------------------------------------+-------------------------------+

En tant que consommateur, afficher les objets dans le partage sales_s fourni par le compte ab67890 :

DESC SHARE ab67890.sales_s;

+----------+----------------------------------+---------------------------------+
| kind     | name                             | shared_on                       |
|----------+----------------------------------+---------------------------------|
| DATABASE | <DB>                             | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA   | <DB>.AGGREGATES_EULA             | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE    | <DB>.AGGREGATES_EULA.AGGREGATE_1 | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+----------------------------------+---------------------------------+

Dans cet exemple, une base de données n’a pas encore été créée dans le compte consommateur à partir du partage sales_s.