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.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

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