Catégories :

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

DESCRIBE SHARE

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

DESCRIBE peut être abrégé en DESC.

Voir aussi :

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.