DESCRIBE LISTING

Beschreibt die Spalten in einem Freigabeangebot.

Siehe auch:

CREATE LISTING, ALTER LISTING, SHOW LISTINGS, SHOW VERSIONS IN LISTING, DROP LISTING

Syntax

{ DESC | DESCRIBE } LISTING <name>  [ REVISION = { DRAFT | PUBLISHED } ]
Copy

Parameter

name

Der Bezeichner, der beim Erstellen des Freigabeangebots für das zu beschreibende Freigabeangebot angegeben wurde. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen zu den Details von Freigabeangeboten, einschließlich des Namens von Freigabeangeboten, finden Sie unter SHOW LISTINGS.

REVISION = { DRAFT | PUBLISHED }

Gibt an, welche Version angezeigt werden soll.

Wenn Sie zum Beispiel einen Entwurf eines veröffentlichten Freigabeangebots haben, können Sie entweder den Entwurf oder die veröffentlichte Version anzeigen lassen.

Gültige Werte:
  • DRAFT: Beschreiben Sie die Entwurfsversion des Angebots.

  • PUBLISHED: Beschreiben Sie die veröffentlichte Version des Angebots.

Standard:

PUBLISHED

Nutzungshinweise

  • Um ein Freigabeangebot mit DESCRIBE zu beschreiben, müssen Sie eine Rolle verwenden, die über die Berechtigung USAGE, MODIFY oder OWNERSHIP für das Freigabeangebot verfügt.

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.

    Die Namen der Ausgabespalten für diesen Befehl werden in Kleinbuchstaben generiert. Wenn Sie ein Resultset dieses Befehls mit dem Pipe-Operator oder der RESULT_SCAN-Funktion verbrauchen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen in der Abfrage, um sicherzustellen, dass sie mit den Spaltennamen in der gescannten Ausgabe übereinstimmen. Wenn der Name einer Ausgabespalte beispielsweise type lautet, geben Sie "type" für den Bezeichner an.

Ausgabe

Die Befehlsausgabe enthält Eigenschaften und Metadaten des Freigabeangebots in den folgenden Spalten:

Spalte

Beschreibung

global_name

Globaler Name des Freigabeangebots

name

Name, der beim Erstellen des Freigabeangebots angegeben wurde.

owner

Der Eigentümer des Freigabeangebots

owner_role_type

Typ der Eigentümerrolle des Freigabeangebots

created_on

Datum und Uhrzeit, zu der das Freigabeangebot erstellt wurde

updated_on

Datum und Uhrzeit der letzten Aktualisierung des Freigabeangebots

published_on

Datum und Uhrzeit der letzten Veröffentlichung des Freigabeangebots

title

Titel, der in der Manifest-Datei des Freigabeangebots angegeben ist

subtitle

Untertitel, der in der Manifest-Datei des Freigabeangebots angegeben ist

description

Beschreibung des Freigabeangebots

target_accounts

Durch Kommata getrennte Liste von Zielkonten.

is_monetized

Flag für Monetarisierung.

is_application

Flag für Anwendung. Unter true wird dem Freigabeangebot ein Anwendungspaket beigefügt

is_targeted

Flag für Ziel.

state

Status des Freigabeangebots. Optionen:

  • DRAFT

  • PUBLISHED

  • UNPUBLISHED

revisions

Revisionsstand, nur für öffentliche Freigabeangebote

comment

Zugehöriger Kommentar, falls vorhanden.

refresh_schedule

Die Aktualisierungshäufigkeit des Freigabeangebots in Minuten

refresh_type

Der Aktualisierungstyp des Freigabeangebots

business_needs

Die geschäftlichen Anforderungen, die das Freigabeangebot erfüllt.

usage_examples

Der Anwendungsfall für das Freigabeangebot

listing_terms

Die Bedingungen für das Freigabeangebot

profile

Name des Anbieterprofils, der in der Manifest-Datei des Freigabeangebots angegeben ist

customized_contact_info

Kontaktinformationen des Anbieters.

application_package

Das mit dem Freigabeangebot verbundene Anwendungspaket

data_dictionary

Metadaten des Freigabeangebots

regions

Die Regionen des Freigabeangebots

manifest_yaml

Das gesamte veröffentlichte Manifest, wenn REVISION PUBLISHED ist, und das gesamte veröffentlichte Manifest mit Änderungsentwürfen, wenn REVISION DRAFT ist.

review_state

Der Überprüfungsstatus des Freigabeangebots

rejection_reason

Grund für die Ablehnung des Freigabeangebots

categories

Freigabeangebotskategorien

resources

Freigabeangebotsressourcen

unpublished_by_admin_reasons

Der Grund, warum der Eigentümer der Auflistung diese nicht veröffentlicht hat.

request_approval_type

Zeigt den Typ der Zugriffsanfrage für das Freigabeangebot an. Der Zugriffsanforderungstyp definiert, wie Erkennungsziele eines Freigabeangebots Zugriffsanforderungen an den Genehmigenden des Freigabeangebots übermitteln. Eine der folgenden Optionen:

  • NULL

  • REQUEST_AND_APPROVE_IN_SNOWFLAKE zeigt an, dass Zugriffsanforderungen in der Snowflake-Umgebung eingereicht und genehmigt werden.

  • REQUEST_AND_APPROVE_OUTSIDE_SNOWFLAKE zeigt an, dass der Anbieter die Eingaben und Genehmigungen von Zugriffsanfragen unabhängig verwaltet. Der Wert für externe Freigabeangebote ist immer NULL.

Beispiele

Beschreiben der Spalten in einem Freigabeangebot namens MYLISTING:

DESC LISTING MYLISTING;
Copy
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
|   global_name                |   name              |   owner          |   owner_role_type   |   created_on                         |   updated_on                         |   published_on                       |   title                                                        |   subtitle                                         |   description                                                                                                              |   target_accounts   |   is_monetized   |   is_application   |   is_targeted   |   state       |   revisions         |   comment   |   refresh_schedule   |   refresh_type    |   business_needs                                                                                                                                         |   usage_examples                                                                                                     |   listing_terms         |   profile                                        |   customized_contact_info   |  application_package |  data_dictionary                                                                                                                   |   regions   |   manifest_yaml                                                                   |   review_state   |   rejection_reason   |   categories   |   resources                                                                                                     |   unpublished_by_admin_reason   | request_approval_type |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
|   GZ13Z1VEWNG                |   CDC_COVID_19_DATA |   ACCOUNTADMIN   |   ROLE              |   2023-12-01T13:01:13.367-08:00      |   2023-12-01T13:25:11.331-08:00      |   2023-12-01T13:25:11.331-08:00      |   Understanding COVID-19: Explore the Latest Data from the CDC |   Track cases, deaths, vaccination rates, and more |   Get the most up-to-date information on the COVID-19 pandemic from the Centers for Disease Control and Prevention (CDC).  |                     |   false          |   false            |   false         |   PUBLISHED   |   DRAFT,PUBLISHED   |             |   60 MINUTE          |   FULL_DATABASE   |   [{""type"":""CUSTOM"",""name"":""Public Health Monitoring and Response"",""description"":""Monitor trends in cases, deaths, and other key metrics.""}] |   [{""title"":""Identify potential outbreaks of COVID-19 in [country name] by tracking trends in confirmed cases"    |   {"type":"STANDARD"}   |   RAVENCLAW_9A314599_F644_4664_946B_4DE0B2169C28 |                             |                      |  {""database"":""COVIDDATADB"",""objects"":[{""schema"":""PUBLIC"",""domain"":""TABLE"",""name"":""GLOBAL_COVID_STATISTICS""}]}"   |   ALL       |   title: "Understanding COVID-19: Explore the Latest Data from the CDC"  . . .    |                  |                      |   HEALTH       |   "{""documentation"":""https://snowflake.com/doc"",""media"":""https://www.youtube.com/watch?v=AR88dZG-hwo""}" |                                 | NULL                  |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+