DESCRIBE SHARE

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>
Copy

Consommateurs (partage entrant)

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

Paramètres

name

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.

provider_account.share_name

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 l’opérateur de canal (->>) ou la fonction RESULT_SCAN. Les deux constructions traitent la sortie comme un jeu de résultats que vous pouvez interroger.

    Les noms des colonnes de sortie pour cette commande sont générés en minuscules. Si vous consommez un jeu de résultats de cette commande avec l’opérateur de canal ou la fonction RESULT_SCAN, utilisez des identificateurs entre guillemets doubles pour les noms de colonnes de la requête, afin de vous assurer qu’ils correspondent aux noms de colonnes dans la sortie analysée. Par exemple, si le nom d’une colonne de sortie est type, spécifiez "type" pour l’identificateur.

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 |
+----------+--------------------------------------+-------------------------------+
Copy

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 |
+----------+----------------------------------+---------------------------------+
Copy

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

Langage: Français