スキーマ：: ORGANIZATION_USAGE

PIPES ビュー¶

重要

この表示は組織アカウントでのみ利用可能です。詳細については、組織アカウントのプレミアムビューをご参照ください。

このOrganization Usageビューは、アカウントに定義された各パイプの行を表示します。

列¶

組織レベルの列

列名	データ型	説明
ORGANIZATION_NAME	VARCHAR	組織の名前。
ACCOUNT_LOCATOR	VARCHAR	システムが生成したアカウントの識別子。
ACCOUNT_NAME	VARCHAR	ユーザー定義のアカウント識別子。

追加列

列名	データ型	説明
PIPE_ID	NUMBER	Internal or system-generated identifier for the pipe.
PIPE_NAME	VARCHAR	The name of the pipe object. 手動で作成されたパイプの場合、これは CREATE PIPE ステートメントで定義されている名前です。 Snowpipe Streaming の高パフォーマンスのデフォルトパイプの場合、これはターゲットテーブル名から派生されます（例: `MY_TABLE-STREAMING`）。
PIPE_SCHEMA_ID	NUMBER	Internal or system-generated identifier for the schema that the pipe belongs to. デフォルトのパイプの場合、これはターゲットテーブルのスキーマ ID に対応します。
PIPE_SCHEMA	VARCHAR	パイプが属するスキーマ。デフォルトのパイプの場合、これはターゲットテーブルのスキーマに対応します。
PIPE_CATALOG_ID	NUMBER	Internal or system-generated identifier for the database that the pipe belongs to. デフォルトのパイプの場合、これはターゲットテーブルのデータベース ID に対応します。
PIPE_CATALOG	VARCHAR	Name of the database that the pipe belongs to. デフォルトのパイプの場合、これはターゲットテーブルのデータベースに対応します。
IS_AUTOINGEST_ENABLED	VARCHAR	パイプに対して AUTO-INGEST が有効になっているかどうか。将来の機能を表します。
NOTIFICATION_CHANNEL_NAME	VARCHAR	DEFINITION 列で指定されたステージのAmazon SQS キューのAmazonリソース名。将来の機能を表します。
PIPE_OWNER	VARCHAR	パイプを所有するロールの名前。デフォルトパイプに対し NULL を返します。
DEFINITION	VARCHAR	キューファイルからSnowflakeテーブルにデータをロードするために使用される COPY ステートメント。
CREATED	TIMESTAMP_LTZ	パイプの作成時間。
LAST_ALTERED	TIMESTAMP_LTZ	オブジェクトが DML、 DDL、またはバックグラウンドでのメタデータ処理によって最後に変更された日時。使用上の注意をご参照ください。
COMMENT	VARCHAR	このパイプのコメント。デフォルトパイプに対して次のメッセージを返します。「テーブルへの Snowpipe Streaming 高性能取り込み用のデフォルトパイプ。Snowflakeによって作成および管理されます。」
PATTERN	VARCHAR	コピーオプションが指定されていた場合は、パイプ定義の COPY INTO <テーブル> ステートメントの PATTERN コピーオプション値。
DELETED	TIMESTAMP_LTZ	パイプが削除された日時。
OWNER_ROLE_TYPE	VARCHAR	オブジェクトを所有するロールの型（例: ROLE）。 Snowflake Native Appがオブジェクトを所有している場合、値は APPLICATION になります。オブジェクトを削除した場合、削除されたオブジェクトには所有者ロールがないため、Snowflakeは NULL を返します。デフォルトパイプに対し NULL を返します。

使用上の注意¶

ビューの遅延は最大24時間です。

ビューには、セッションの現在のロールにアクセス権が付与されているオブジェクトのみが表示されます。
ビューは MANAGE GRANTS 権限を尊重しないため、 MANAGE GRANTS 権限を持つユーザーが両方を実行する場合、 SHOW コマンドよりも表示される情報が少なくなる場合があります。
LAST_ALTERED 列は、オブジェクトに対して以下の操作を実行したときに更新されます。
- DDL 操作。
- DML 操作（テーブル用のみ）。この列は、 DML ステートメントによって影響を受ける行がない場合でも更新されます。
- Snowflakeが実行するメタデータのバックグラウンド保守作業。

例¶

次の例では、このビューを PIPE_ID 列の PIPE_USAGE_HISTORY ビューに結合して、一意の各 PIPE オブジェクトに関連付けられたクレジット使用状況を追跡します。

select a.PIPE_CATALOG as PIPE_CATALOG,
       a.PIPE_SCHEMA as PIPE_SCHEMA,
       a.PIPE_NAME as PIPE_NAME,
       b.CREDITS_USED as CREDITS_USED
from SNOWFLAKE.ORGANIZATION_USAGE.PIPES a join SNOWFLAKE.ORGANIZATION_USAGE.PIPE_USAGE_HISTORY b
on a.pipe_id = b.pipe_id
where b.START_TIME > date_trunc(month, current_date);

Copy