SHOW CHANNELS

アクセス権限を持つ Snowpipe Streamingチャネル をリストします。このコマンドを使用して、指定したテーブル、データベースまたはスキーマ（またはセッションの現在のデータベース/スキーマ）、またはアカウント全体のチャネルをリストできます。

こちらもご参照ください。

構文

SHOW CHANNELS [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>            |

                  TABLE                    |
                  TABLE <table_name>       |

                  PIPE                     |
                  PIPE <pipe_name>
                }
           ]
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

[ IN ... ]

オプションで、コマンドのスコープを指定します。次のいずれかを指定します。

ACCOUNT

アカウント全体の記録を返します。

DATABASE、 . DATABASE db_name

現在使用中のデータベースまたは指定されたデータベース（db_name）の記録を返します。

db_name なしで DATABASE を指定し、かつデータベースが使用されていない場合、キーワードは出力に影響しません。

注釈

データベースコンテキストで IN 句を指定せずに SHOW コマンドを使用すると、予想よりも少ない結果になる可能性があります。

IN 句を使用しない場合、同じ名前のオブジェクトは一度だけ表示されます。例えば、 schema1 にテーブル t1 、そして schema2 にテーブル t1 があり、両方とも指定したデータベースコンテキストのスコープ内にある場合（つまり、選択したデータベースが schema1 と schema2 の親である場合）の場合、 SHOW TABLES は t1 テーブルの1つのみを表示します。

SCHEMA、 . SCHEMA schema_name

現在使用中のスキーマまたは指定されたスキーマ（schema_name）の記録を返します。

データベースが使用中の場合、または完全修飾 schema_name （例: db.schema） を指定する場合、 SCHEMA はオプションです。

データベースが使用されていない場合は、 SCHEMA を指定しても出力には影響しません。

TABLE、 . TABLE table_name

テーブルの記録を返します。

IN ... を省略した場合、コマンドのスコープは、セッションで現在使用中のデータベースがあるかどうかによって異なります。

  • If a database is currently in use, the command returns the objects you have privileges to view in the database. This has the same effect as specifying IN DATABASE.

  • If no database is currently in use, the command returns the objects you have privileges to view in your account. This has the same effect as specifying IN ACCOUNT.

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者（ ACCOUNTADMIN ロールを持つユーザー）とセキュリティ管理者（ SECURITYADMIN ロールを持つユーザー）のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子 （->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンドの出力から特定の列を選択したり、行をフィルター処理したりできます。

    出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

    SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

出力

コマンド出力では、次の列にパイプのプロパティとメタデータが提供されます。

列

説明

created_on

チャネルが作成された日時。

name

チャネルの名前。

database_name

Snowpipe Streamingチャネルが論理的に格納されているデータベースの名前。

名前付きチャネル:ユーザー定義チャネルが作成されるデータベースの名前。

デフォルトのパイプ（高性能）:ターゲットテーブルのデータベースの名前。

schema_name

Snowpipe Streamingチャネルが論理的に格納されているスキーマの名前。

Named channel: The name of the schema where the user-defined channel is created.

デフォルトのパイプ（高性能）:ターゲットテーブルのスキーマの名前。

table_name

データインジェスチョンのためにチャネルがマッピングされるSnowflakeテーブルの名前。

Snowpipe Streamingの従来のチャンネルの場合:列にはターゲットテーブルの名前が表示され、チャネルのマッピングが確立されます。

デフォルトのパイプの場合（高性能）:列にはターゲットテーブルの名前が入力され、デフォルトのパイプの宛先に対するコンテキストが提供されます。

client_sequencer

内部での使用。

row_sequencer

内部での使用。

offset_token

String used to track the ingestion process.

parent_name

Table or pipe where the channel is mapped to.

parent_domain

Domain (table or pipe) where the channel is mapped to.

例

mydb データベースにある public スキーマで表示する権限があるすべてのチャネルを表示します。

use database mydb;

show channels;

+-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
| created_on                    | name      | database_name | schema_name      | table_name             | client_sequencer | row_sequencer | offset_token |
|-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
| 2023-05-05 17:13:17.579 -0700 | CHANNEL8  | TEST_DB1      | STREAMING_INGEST | STREAMING_INGEST_TABLE | 7                | 1             | 0            |
|                               |           |               |                  |                        |                  |               |              |
+-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
Copy

特定のパイプのすべてのチャネルを表示します。

show channels in pipe MY_PIPE;
Copy
言語: 日本語