MaxCompute のテナントレベルのメタデータサービスである Information Schema について紹介します。 - MaxCompute

このトピックでは、MaxCompute のテナントレベルのメタデータサービスである Information Schema について、その特徴、制限事項、注意事項、メタデータビュー、RAM ユーザーへの権限付与について説明します。

特徴

MaxCompute の Information Schema を使用すると、プロジェクトのメタデータと使用履歴にアクセスできます。テナントレベルの Information Schema は、元の Information Schema を強化します。これは、MaxCompute に固有のフィールドとビューを追加することで、ANSI SQL-92 Information Schema を拡張します。各 Alibaba Cloud アカウントに対して、MaxCompute は、組み込みの INFORMATION_SCHEMA を含む SYSTEM_CATALOG という名前のプロジェクトを自動的に作成します。

この組み込みスキーマの読み取り専用ビューにアクセスすることで、Alibaba Cloud アカウント内のすべてのプロジェクトのメタデータと使用履歴をクエリできます。システムは、メタデータとジョブ履歴データを SYSTEM_CATALOG.INFORMATION_SCHEMA にのみ格納します。

Information Schema のメタデータビューを使用して、メタデータを参照および取得します。
Information Schema の使用状況情報ビューを使用して、ジョブのパフォーマンスを分析します。リソース消費量、ランタイム期間、処理データなどのメトリックを確認して、ジョブを最適化したり、リソース容量を計画したりできます。

ビューによってデータの鮮度とデフォルトの保持期間は異なります。保持期間を超えたデータにはアクセスできなくなります。履歴データのスナップショットを作成したり、ジョブ履歴を 14 日以上保持したりする必要がある場合は、Information Schema からローカルテーブルまたは指定したプロジェクトに定期的にデータをエクスポートできます。

データをエクスポートする際は、INSERT INTO SELECT * FROM information_schema.*** のようなクエリは使用せず、ビューの列名を明示的に指定してください。こうすることで、ビューに新しい列が追加された際のバックアップ失敗を防げます。

適用範囲

Information Schema は、現在のユーザーをスコープとするメタデータビューを提供します。メタデータセンター間のメタデータアクセスはサポートしていません。メタデータセンターは次のように構成されています：
- 中国本土リージョン (中国 (上海)、中国 (杭州)、中国 (北京)、中国 (深セン)、中国 (成都)、中国 (張家口)、中国 (ウランチャブ)) は、1 つのメタデータセンターを共有します。
- 中国 (香港) リージョンは、独立したメタデータセンターです。
- 各国際リージョンには、独自のメタデータセンターがあります。
- 金融クラウド (上海金融および深セン金融) は、1 つのメタデータセンターを共有します。
- 中国 (北京) の政府クラウドは、独立したメタデータセンターです。
組み込みの SYSTEM_CATALOG プロジェクトは読み取り専用です。これをクエリするには、対応するリージョン内のプロジェクトからジョブを実行する必要があります。詳細については、「クエリの例」をご参照ください。
現在、これらのテーブルは、MaxCompute SQL 分析、最新のクライアントバージョン、および DataWorks の DataStudio または SQL スケジューリングノードから SQL を使用してのみクエリできます。
メタデータシステムテーブルは、ほぼリアルタイムのビューを提供します。メタデータの高い鮮度が要求されるアプリケーションには、SDK/CLI を使用して特定のオブジェクトのメタデータを直接取得することを推奨します。

料金

コンピューティングコスト
- 従量課金のコンピューティングリソースを使用するプロジェクトの場合、Information Schema ビューをクエリするとクエリコストが発生します。コストは、ビューへのアクセス時に実行される基盤となる SQL クエリに依存します。
  クエリパフォーマンスを向上させ、スキャンされるデータ量を削減するために、Information Schema ビューは 範囲クラスター化テーブル で最適化されています。
  TASKS_HISTORY および TUNNELS_HISTORY ビューをクエリする際に、スキャンされるデータ量を最小限に抑え、クエリコストを削減するには、毎日 06:00:00 以降に前日のデータをクエリしてください。当日のデータのクエリは避けてください。
- サブスクリプションのコンピューティングリソースを使用するプロジェクトの場合、Information Schema ビューに対するクエリは、購入した CU (コンピュートユニット) を消費します。
ストレージコスト：Information Schema ビューのストレージに対しては課金されません。

メタデータビュー

ビュー	説明	適時性	遅延の説明
CATALOGS	プロジェクトをリストします。	ほぼリアルタイムのビュー	データは約 3 時間遅延します。
CATALOG_PRIVILEGES	プロジェクトレベルの権限をリストします。
COLUMNS	各プロジェクトの列をリストします。
COLUMN_DATA_MASKING_POLICIES	各プロジェクトの列のデータマスキングポリシーをリストします。
COLUMN_LABEL_GRANTS	各プロジェクトの列に対するラベル付与をリストします。
COLUMN_LABELS	各プロジェクトのテーブルの列レベルのラベルをリストします。
COLUMN_PRIVILEGES	各プロジェクトのテーブルの列レベルの権限をリストします。
DATA_MASKING_POLICIES	各プロジェクトのデータマスキングポリシーをリストします。
INSTALLED_PACKAGES	各プロジェクトにインストールされているパッケージをリストします。
PACKAGE_PRIVILEGES	パッケージに対する権限付与をリストします。
PACKAGE_OBJECTS	パッケージ内のオブジェクトをリストします。
PARTITIONS	各プロジェクトのパーティションをリストします。
PARTITION_ACCESS_INFO	各プロジェクトのパーティションのアクセス統計をリストします。
RESOURCES	各プロジェクトのリソースをリストします。
RESOURCE_PRIVILEGES	各プロジェクトのリソースに対する権限をリストします。
ROLES	プロジェクトレベルおよびアカウントレベルのロールをリストします。
TABLES	各プロジェクトのテーブルをリストします。
TABLE_ACCESS_INFO	各プロジェクトのテーブルのアクセス統計をリストします。
TABLE_LABEL_GRANTS	テーブルに対するラベル付与をリストします。
TABLE_LABELS	各プロジェクトのテーブル上のラベルをリストします。
TABLE_PRIVILEGES	各プロジェクトのテーブルに対する権限をリストします。
UDF_PRIVILEGES	各プロジェクトの UDF に対する権限付与をリストします。
UDFS	各プロジェクトの UDF をリストします。
UDF_RESOURCES	各プロジェクトの UDF のリソース依存関係をリストします。
USERS	ユーザーをリストします。
USER_ROLES	ユーザーに割り当てられたロールをリストします。
SCHEMAS	各プロジェクトのスキーマをリストします。
TASKS	実行中のタスクのリアルタイムスナップショットを提供します。このビューはリアルタイムのタスクモニタリングに使用します。		データは数秒遅延します。この機能はプレビュー版であり、SLA の対象外です。段階的に展開されます。
TASKS_HISTORY	各プロジェクトで完了したタスクの履歴を提供します。これはパーティションテーブルで、過去 14 日間のデータを保持します。		データは約 3 時間遅延します。
TUNNELS_HISTORY	トンネルを介した一括アップロードおよびダウンロードの履歴を提供します。これはパーティションテーブルで、過去 14 日間のデータを保持します。		データは約 3 時間遅延します。

クエリの例

以下の例では、メタデータをクエリする方法を示します。

例 1：ターゲットプロジェクト内のすべてのテーブルのメタデータをクエリします。

-- このクエリはテナント内のプロジェクトから実行します。
USE <project_name>;
SET odps.namespace.schema=true;
SELECT * FROM SYSTEM_CATALOG.INFORMATION_SCHEMA.tables;

例 2：ターゲットプロジェクトのメタデータセンターからすべてのジョブ履歴をクエリし、日付フィールドで結果をフィルタリングします。

-- このクエリはテナント内のプロジェクトから実行します。
USE <project_name>;
SET odps.namespace.schema=true;
SELECT * FROM SYSTEM_CATALOG.INFORMATION_SCHEMA.tasks_history where ds='yyyymmdd' limit 100;

RAM ユーザーへの権限付与

Information Schema のビューには、すべてのテナントレベルのユーザーデータが含まれています。デフォルトでは、Alibaba Cloud アカウント (プライマリアカウント) のみがこのデータを表示できます。RAM ユーザー (サブアカウント) がこのデータにアクセスする必要がある場合は、必要な権限を付与する必要があります。

説明

Alibaba Cloud アカウント (プライマリアカウント) またはアカウントレベルの Super_Administrator もしくは Admin ロールを持つ RAM ユーザー (サブアカウント) のみがこれらの権限を付与できます。

MaxCompute コンソールにログインし、左上のコーナーでリージョンを選択します。
左側のナビゲーションウィンドウで、構成の管理 > テナント管理 を選択します。
テナント管理 ページで、ロール管理 タブをクリックします。

ロール管理タブで、新しいロールをクリックします。ポップアップ表示される新しいロールダイアログボックスで、カスタムのロール名:とポリシーの内容:を入力し、 OK をクリックしてロールを作成します。

たとえば、新しいロールは SYSTEM_CATALOG.INFORMATION_SCHEMA のすべてのビューを表示できます。ポリシーの内容: は、次のように設定されます。

{
    "Statement":[
        {
            "Action":[
                "odps:Describe",
                "odps:Select"
            ],
            "Effect":"Allow",
            "Resource":[
                "acs:odps:*:catalogs/system_catalog/schemas/information_schema/tables/*"
            ]
        },
        {
            "Action":[
                "odps:List"
            ],
            "Effect":"Allow",
            "Resource":[
                "acs:odps:*:catalogs/system_catalog/schemas/information_schema"
            ]
        }
    ],
    "Version":"1"
}

テナント管理 ページで、ユーザー管理 タブをクリックします。
ユーザー管理タブで新しいメンバーをクリックします。メンバーの追加ダイアログボックスで、ロールを割り当てるアカウントを選択するか、手動で追加します。バッチ設定の役割エリアで、これらのアカウントに割り当てるロールを選択し、をクリックし、次に決定をクリックして構成を完了します。
ユーザー管理の詳細については、「ユーザー計画と管理」をご参照ください。

Catalogs

各カタログには次のフィールドが含まれます。

パラメーター	型	説明
catalog_name	STRING	カタログの名前。
status	STRING	カタログのステータス。有効な値：Allowed および Denied。
create_time	DATETIME	カタログが作成された時間。
owner_id	STRING	カタログ所有者の ID。
owner_name	STRING	カタログ所有者の Alibaba Cloud アカウント名。
settings	STRING	カタログの設定。
region	STRING	カタログのリージョン。

CATALOG_PRIVILEGES

プロジェクトレベルの権限、たとえば `CreateInstance` や `ListTable` など。

パラメーター	型	説明
catalog_name	STRING	プロジェクト名。
user_catalog	STRING	被付与者のプロジェクト。
user_name	STRING	被付与者の名前。
user_id	STRING	被付与者の ID。
grantor	STRING	付与者。このフィールドは予約済みです。
privilege_type	STRING	権限のタイプ。

Columns

このビューは、各プロジェクトのテーブルの列をリストします。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。この値は現在 NULL です。
table_name	STRING	テーブルの名前。
column_name	STRING	列の名前。
ordinal_position	BIGINT	列の序数位置。
column_default	STRING	列のデフォルト値。
is_nullable	BOOLEAN	列が NULL 値を含むことができる場合は `TRUE`、それ以外の場合は `FALSE`。
data_type	STRING	列のデータ型、たとえば STRING や BIGINT など。
column_comment	STRING	列のコメント。
is_partition_key	BOOLEAN	列がパーティション列である場合は `TRUE`、それ以外の場合は `FALSE`。
is_primary_key	BOOLEAN	列がプライマリキー列である場合は `TRUE`、それ以外の場合は `FALSE`。

列のデータマスキングポリシー

このビューは、各プロジェクトのテーブル列に対するデータマスキングポリシーを示します。

パラメーター	型	説明
table_catalog	STRING	テーブルが属するプロジェクトの名前。
table_schema	STRING	テーブルが属するスキーマの名前。
table_name	STRING	テーブルの名前。
column_name	STRING	列の名前。
policy_name	STRING	ポリシーの名前。

COLUMN_LABEL_GRANTS

このビューには、各プロジェクトのテーブル列に対するラベル付与に関する情報が含まれています。

パラメーター	型	値
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。
table_name	STRING	テーブルの名前。
column_name	STRING	列の名前。
user_catalog	STRING	ユーザーが属するプロジェクトの名前。
user_name	STRING	ユーザーの名前。
user_id	STRING	ユーザーの ID。
grantor	STRING	ラベルの付与者。これは予約済みのフィールドです。
label_level	STRING	付与されたラベルのレベル。
expired	DATETIME	有効期限。

列のラベル

このビューには、各プロジェクトのテーブルの列レベルのラベル情報が含まれています。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。これは現在 NULL です。
table_name	STRING	テーブルの名前。
column_name	STRING	列の名前。
label_type	STRING	ラベルのタイプ。
label_level	STRING	ラベルのレベル。

COLUMN_PRIVILEGES

このビューは、各プロジェクトのテーブルに対する列レベルの権限をリストします。

列	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。
table_name	STRING	テーブルの名前。
column_name	STRING	列の名前。
user_catalog	STRING	ユーザーを含むプロジェクトの名前。
user_name	STRING	ユーザーの名前。
user_id	STRING	ユーザー ID。
grantor	STRING	このフィールドは予約済みです。
privilege_type	STRING	権限のタイプ。

データマスキングポリシー

このビューは、各プロジェクトのデータマスキングルールをリストします。

パラメーター	型	説明
policy_catalog	STRING	ポリシーを含むプロジェクトの名前。
policy_name	STRING	ポリシーの名前。
policy_type	STRING	ポリシーのデータマスキングのタイプ。
user_name	STRING	このポリシーが適用されるユーザーアカウント。
user_id	STRING	このポリシーが適用されるユーザーアカウントの ID。
is_default	BOOLEAN	これがデフォルトポリシーである場合は `TRUE`、それ以外の場合は `FALSE`。
create_time	DATETIME	ポリシーが作成された時間。
last_modified_time	DATETIME	ポリシーが最後に変更された時間。
options	STRING	ポリシーの構成オプション。

INSTALLED_PACKAGES

このビューは、各プロジェクトにインストールされているパッケージをリストします。

パラメーター	型	説明
installed_package_catalog	STRING	パッケージがインストールされているプロジェクトの名前。
package_catalog	STRING	パッケージを所有するプロジェクト。
package_name	STRING	パッケージの名前。
installed_time	STRING	パッケージがインストールされた日時。
allowed_label	STRING	パッケージの共有を制御するラベル。

パッケージの権限

パッケージの権限に関する情報。

パラメーター	型	説明
package_catalog	STRING	パッケージを含むプロジェクト。
package_name	STRING	パッケージ名。
user_catalog	STRING	被付与者を含むプロジェクト。
user_name	STRING	被付与者名。
user_id	STRING	被付与者 ID。
grantor	STRING	付与者。このフィールドは予約済みです。
privilege_type	STRING	権限のタイプ。

PACKAGE_OBJECTS

このビューは、パッケージ内のオブジェクトを記述します。

パラメーター	型	説明
package_catalog	STRING	パッケージを含むプロジェクト。
package_name	STRING	パッケージの名前。
object_schema	STRING	パッケージオブジェクトのスキーマ。
object_type	STRING	パッケージオブジェクトのタイプ。
object_name	STRING	パッケージオブジェクトの名前。
column_name	STRING	テーブル列の名前。このフィールドは object_type が 'table' の場合にのみ返されます。
allowed_privilege	STRING	オブジェクトに許可された権限。
allowed_label	STRING	オブジェクトに許可されたラベル。

Partitions

このビューには、各プロジェクトのテーブルパーティションに関する情報が含まれています。

パラメーター	型	値
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。
table_name	STRING	テーブルの名前。
partition_name	STRING	パーティションの名前。
create_time	DATETIME	パーティションの作成時間。
last_modified_time	DATETIME	パーティションの最終変更時間。
last_access_time	DATETIME	パーティションのおおよその最終アクセス時間。実際の時間とは最大 24 時間異なる場合があります。このフィールドのデータ収集は 2023 年 7 月から段階的にアップグレードされています。アップグレード以降にアクセスされていないパーティションの `last_access_time` は記録されません。また、ALGO ジョブや Hologres からの直接読み取りでアクセスされたものも記録されません。
data_length	BIGINT	パーティションのデータサイズ (バイト単位)。
is_archived	BOOLEAN	将来の使用のために予約されています。
is_exstore	BOOLEAN	将来の使用のために予約されています。
storage_tier	STRING	階層型ストレージの識別子。有効な値： `standard`：標準ストレージ。 `lowfrequency`：低頻度アクセスストレージ。 `longterm`：長期ストレージ。
cluster_type	STRING	MaxCompute テーブルのクラスタータイプ。有効な値： `HASH` `RANGE`
number_buckets	BIGINT	オプション。クラスター化テーブルのバケット数。値が 0 の場合、システムがジョブのランタイムにこの数を決定します。
lifecycle_enabled	BOOLEAN	パーティションに対してライフサイクルポリシーが有効になっているかどうかを指定します。

PARTITION_ACCESS_INFO

このビューは、各プロジェクトのテーブルパーティションのアクセス統計をリストします。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。3 層モデルを使用しないプロジェクトの場合、この値は 'default' です。
table_name	STRING	テーブル名。
partition_name	STRING	パーティション名。
access_count	BIGINT	アーカイブ日における総アクセス数。
access_bytes	BIGINT	アーカイブ日にアクセスされたデータの総サイズ (バイト単位)。
ds	STRING	データがアーカイブされた日付。

Resources

各プロジェクトのリソースに関する情報を提供します。

パラメーター	型	説明
resource_catalog	STRING	リソースを含むプロジェクトの名前。
resource_schema	STRING	リソースを含むスキーマ。
resource_name	STRING	リソースの名前。
resource_type	STRING	リソースのタイプ。有効な値は次のとおりです： archive py jar table
owner_id	STRING	リソース所有者の ID。
owner_name	STRING	リソースを所有する Alibaba Cloud アカウントの名前。
create_time	DATETIME	リソースの作成時間。
last_modified_time	DATETIME	リソースの最終変更時間。
size	BIGINT	リソースのサイズ (バイト単位)。
comment	STRING	リソースのコメント。
is_temp_resource	BOOLEAN	リソースが一時的なものであるかどうかを示します。

リソースの権限

各プロジェクトのリソースの権限をリストします。

パラメーター	型	値
resource_catalog	STRING	リソースを含むプロジェクトの名前。
resource_schema	STRING	リソースを含むスキーマ。
resource_name	STRING	リソースの名前。
user_catalog	STRING	被付与者のプロジェクト。
user_name	STRING	被付与者の名前。
user_id	STRING	被付与者の ID。
grantor	STRING	付与者。これは予約済みのフィールドです。
privilege_type	STRING	権限のタイプ。

Roles

プロジェクトレベルおよびアカウントレベルのロールをリストします。

パラメーター	型	説明
role_catalog	STRING	ロールを含むプロジェクト。`NULL` 値はテナントロールを示します。
role_name	STRING	ロールの名前。
role_label	STRING	ロールのラベル。
comment	STRING	ロールの説明。

Tables

各プロジェクトのテーブルを記述します。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。
table_name	STRING	テーブル名。
table_type	STRING	テーブルタイプ。有効な値： `MANAGED_TABLE`：マネージドテーブル。 `VIRTUAL_VIEW`：ビュー。 `EXTERNAL_TABLE`：外部テーブル。 `MATERIALIZED_VIEW`：マテリアライズドビュー。
is_partitioned	BOOLEAN	テーブルがパーティションテーブルである場合は `TRUE`、それ以外の場合は `FALSE`。
owner_id	STRING	テーブル所有者の ID。
owner_name	STRING	テーブル所有者の Alibaba Cloud アカウント名。
create_time	DATETIME	テーブルが作成された時間。
last_modified_time	DATETIME	テーブルデータが最後に変更された時間。
last_access_time	DATETIME	テーブルが最後にアクセスされた時間。これはおおよその値であり、実際の最終アクセス時間とは最大 24 時間異なる場合があります。テーブルがパーティションテーブルの場合、この値は `NULL` です。各パーティションの最終アクセス時間を表示するには、PARTITIONS ビューをご参照ください。このフィールドのデータ収集は 2023 年 7 月から段階的にアップグレードされています。アップグレード以降にアクセスされていないテーブル、または ALGO ジョブや Hologres からの直接読み取りでアクセスされたテーブルの `last_access_time` は収集できません。
data_length	BIGINT	テーブルのデータサイズ (バイト単位)。非パーティションテーブルの場合、これはテーブルのデータサイズです。パーティションテーブルの場合、システムは総データサイズを計算しないため、この値は `NULL` です。PARTITIONS ビューには、各パーティションのデータサイズが含まれています。
table_comment	STRING	テーブルのコメント。
lifecycle	BIGINT	テーブルのライフサイクル (日数)。
lifecycle_enabled	BOOLEAN	ライフサイクルポリシーが有効な場合は `TRUE`、それ以外の場合は `FALSE`。
is_archived	BOOLEAN	予約済みのフィールド。
table_exstore_type	STRING	テーブルがエクストリームストレージ内の論理テーブルか物理テーブルかを示します。有効な値： `EXSTORE_TABLE_VIRTUAL`：論理テーブル。 `EXSTORE_TABLE_PHYSICAL`：物理テーブル。
storage_tier	STRING	テーブルの階層型ストレージタイプ。有効な値： `standard`：標準ストレージ。 `lowfrequency`：低頻度アクセスストレージ。 `longterm`：アーカイブストレージ。
cluster_type	STRING	テーブルのクラスタータイプ。有効な値： `HASH` `RANGE`
number_buckets	BIGINT	クラスター化テーブルのバケット数。値が 0 の場合、ジョブ実行時に動的に決定されます。
view_original_text	STRING	`table_type` が `VIRTUAL_VIEW` のテーブルのビュー定義。
has_primary_key	BOOLEAN	テーブルにプライマリキーがある場合は `TRUE`、それ以外の場合は `FALSE`。
is_transactional	BOOLEAN	テーブルがトランザクションテーブルである場合は `TRUE`、それ以外の場合は `FALSE`。
is_delta_table	BOOLEAN	テーブルが Delta Table である場合は `TRUE`、それ以外の場合は `FALSE`。
table_storage	STRING	テーブルのストレージサービス。
table_format	STRING	テーブルのストレージフォーマット、たとえば ORC や Parquet など。

TABLE_ACCESS_INFO

このビューは、各プロジェクトのテーブルのアクセス統計を提供します。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルのスキーマ。3 層モデルのないプロジェクトの場合、この値は `default` です。
table_name	STRING	テーブル名。
access_count	BIGINT	アーカイブ日のアクセス数。
access_bytes	BIGINT	アーカイブ日にアクセスされたデータの総サイズ (バイト単位)。
ds	STRING	データのアーカイブ日。

TABLE_LABEL_GRANTS

テーブルラベルの付与をリストします。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクト。
table_schema	STRING	テーブルを含むスキーマ。
table_name	STRING	テーブルの名前。
user_catalog	STRING	被付与者アカウントを含むプロジェクト。
user_name	STRING	被付与者アカウントの名前。
user_id	STRING	被付与者アカウントの ID。
grantor	STRING	付与者アカウント。これは予約済みのフィールドです。
label_level	STRING	付与されたラベルのレベル。
expired	DATETIME	付与が失効する日時。

TABLE_LABELS

このビューは、各プロジェクトのテーブルに適用されるラベルを記述します。

パラメーター	型	説明
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。これは現在 NULL です。
table_name	STRING	テーブルの名前。
label_type	STRING	ラベルのタイプ。
label_level	BIGINT	ラベルのレベル。

TABLE_PRIVILEGES

各プロジェクトのテーブルに対する権限に関する情報を提供します。

列	型	値
table_catalog	STRING	テーブルを含むプロジェクトの名前。
table_schema	STRING	テーブルを含むスキーマ。これは現在 NULL です。
table_name	STRING	テーブル名。
user_catalog	STRING	被付与者のプロジェクトの名前。
user_name	STRING	被付与者の名前。
user_id	STRING	被付与者の ID。
grantor	STRING	付与者。これは予約済みのフィールドです。
privilege_type	STRING	権限のタイプ。
expired	DATETIME	権限の有効期限。

Tasks

実行中のジョブのリアルタイムスナップショットを提供します。

パラメーター	型	説明
task_catalog	STRING	ジョブを含むプロジェクトの名前。
task_name	STRING	ジョブの名前。
task_type	STRING	ジョブのタイプ。有効な値： `SQL`：SQL ジョブ。 `CUPID`：Spark または Mars ジョブ。 `SQLCost`：SQL コスト見積もりジョブ。 `SQLRT`：クエリアクセラレーション SQL ジョブ。 `LOT`：MapReduce ジョブ。 `PS`：Platform of Artificial Intelligence (PAI) のための Parameter Server ジョブ。 `AlgoTask`：機械学習ジョブ。
inst_id	STRING	インスタンス ID。
status	STRING	ジョブのステータス。有効な値： `Running` `Waiting`
owner_id	STRING	ジョブを送信した Alibaba Cloud アカウントの ID。
owner_name	STRING	ジョブを送信した Alibaba Cloud アカウントの名前。
start_time	DATETIME	ジョブの開始時刻。
priority	BIGINT	ジョブの優先度。
signature	STRING	ジョブの署名。
quota_name	STRING	コンピューティングクォータの名前。
cpu_usage	BIGINT	現在の CPU 使用量。`cores × 100` として計算されます。
mem_usage	BIGINT	現在のメモリ使用量 (メガバイト (MB) 単位)。
gpu_usage	BIGINT	現在の GPU 使用量。`cards × 100` として計算されます。
total_cpu_usage	BIGINT	累積 CPU 使用量。`(cores × 100) × seconds` として計算されます。
total_mem_usage	BIGINT	累積メモリ使用量 (MB 秒単位)。
total_gpu_usage	BIGINT	累積 GPU 使用量。`(cards × 100) × seconds` として計算されます。
cpu_min_ratio	BIGINT	ジョブの現在の CPU 使用量と、そのキューの保証されたリソースレベルとの比率。
mem_min_ratio	BIGINT	ジョブの現在のメモリ使用量と、そのキューの保証されたリソースレベルとの比率。
gpu_min_ratio	BIGINT	ジョブの現在の GPU 使用量と、そのキューの保証されたリソースレベルとの比率。
cpu_max_ratio	BIGINT	ジョブの現在の CPU 使用量と、そのキューの最大エラスティックリソースレベルとの比率。
mem_max_ratio	BIGINT	ジョブの現在のメモリ使用量と、そのキューの最大エラスティックリソースレベルとの比率。
gpu_max_ratio	BIGINT	ジョブの現在の GPU 使用量と、そのキューの最大エラスティックリソースレベルとの比率。
settings	STRING	上位のスケジューラまたはユーザーから渡された情報で、JSON 形式で保存されます。`USERAGENT`、`BIZID`、`SKYNET_ID`、`SKYNET_NODENAME` などのフィールドが含まれる場合があります。
ext_platform_id	STRING	上流のスケジューリングプラットフォームの ID。
ext_node_id	STRING	上流のスケジューラのノード ID。
ext_bizdate	STRING	上流のスケジューラにおけるジョブの業務日付。
ext_task_id	STRING	上流のスケジューラのインスタンス ID。
ext_dagtype	STRING	上流のスケジューラにおけるインスタンスの実行モード。
ext_node_name	STRING	上流のスケジューラのノード名。
ext_node_onduty	STRING	上流のスケジューラにおけるノード所有者の ID。
ext_node_priority	BIGINT	上流のスケジューラのノードの優先度。
ext_node_cyctype	STRING	上流のスケジューラにおけるノードのスケジューリングサイクルタイプ。
ext_subtask_id	STRING	上流のスケジューラにおけるノードのサブタスク ID。
additional_info	STRING	追加情報のための予約済みフィールド。

TASKS_HISTORY

各プロジェクトで完了したジョブの履歴が含まれています。データは過去 14 日間保持されます。

パラメーター	型	説明
task_catalog	STRING	タスクを含むプロジェクトの名前。
task_name	STRING	タスクの名前。
task_type	STRING	タスクのタイプ。指定可能な値： `SQL`：SQL タスク。 `CUPID`：Spark または Mars タスク。 `SQLCost`：SQL コスト見積もりタスク。 `SQLRT`：クエリアクセラレーション付きの SQL タスク。 `LOT`：MapReduce タスク。 `PS`：PAI のための Parameter Server タスク。 `AlgoTask`：機械学習タスク。このタスクタイプでは、リソース消費とデータスキャンに関する情報は利用できません。
inst_id	STRING	インスタンスの ID。
status	STRING	データ収集時のインスタンスのステータス。これはライブステータスではありません。指定可能な値： `Terminated`：インスタンスは完了しました。 `Failed`：インスタンスは失敗しました。 `Cancelled`：インスタンスはキャンセルされました。
owner_id	STRING	ジョブを送信した Alibaba Cloud アカウントの ID。
owner_name	STRING	ジョブを送信した Alibaba Cloud アカウントの名前。
result	STRING	失敗したジョブのエラーメッセージ。
priority	BIGINT	ジョブの優先度。
submit_time	DATETIME	ジョブが送信され、インスタンスが作成された時間。
start_time	DATETIME	タスクが開始された時間。SQL タスクの場合、これはコンパイルが開始された時間です。
end_time	DATETIME	タスクが終了した時間。
input_records	BIGINT	入力レコードの数。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL です。
output_records	BIGINT	出力レコードの数。説明このフィールドは、SQL タスクがクエリ高速化キャッシュにヒットした場合、NULL になります。
input_bytes	BIGINT	標準ストレージからの入力データ量 (バイト単位)。説明このフィールドは、SQL タスクがクエリ高速化キャッシュにヒットした場合、NULL になります。
lowfrequency_storage_input_bytes	BIGINT	低頻度アクセスストレージからの入力データ量 (バイト単位)。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL です。
longterm_storage_input_bytes	BIGINT	アーカイブストレージからの入力データ量 (バイト単位)。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
oss_input_bytes	BIGINT	OSS 外部テーブルからの入力データ量 (バイト単位)。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
tablestore_input_bytes	BIGINT	Tablestore 外部テーブルからの入力データ量 (バイト単位)。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
output_bytes	BIGINT	出力データ量 (バイト単位)。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
input_tables	STRING	入力テーブルのリスト。このフィールドは SQL タスクにのみ適用されます。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
output_tables	STRING	出力テーブルのリスト。このフィールドは SQL タスクにのみ適用されます。説明 SQL タスクがクエリ高速化キャッシュにヒットした場合、このフィールドは NULL になります。
operation_text	STRING	タスクのステートメント。最大サイズは 256 KB です。
signature	STRING	タスクの署名。
quota_name	STRING	コンピュートクォータの名前。
complexity	DOUBLE	SQL タスクの複雑さ。
cost_cpu	DOUBLE	ジョブ CPU 消費量 (値 100 は `1 core × 1 s` を表します。例えば、10 コアで 5 秒間実行した場合、cost_cpu は 10 × 100 × 5 = 5000 となります)。
cost_mem	DOUBLE	タスクのメモリ消費量 (MB 秒単位)。
cost_indicators	STRING	分析と最適化のためのジョブリソースデータ。
settings	STRING	上位のスケジューリングシステムまたはユーザーから渡されたデータで、JSON 文字列として保存されます。このフィールドには `USERAGENT`、`BIZID`、`SKYNET_ID`、`SKYNET_NODENAME` などのパラメーターが含まれる場合があります。
ext_platform_id	STRING	上位のスケジューリングプラットフォームの ID。クライアントはジョブの送信時にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_node_id	STRING	上位のスケジューリングシステムからのノードの ID。クライアントは、ジョブの送信時にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_bizdate	STRING	上位のスケジューリングシステムからのタスクの業務日付。クライアントはジョブを送信する際にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_task_id	STRING	上位のスケジューリングシステムからのタスクのインスタンス ID。クライアントは、ジョブを送信する際にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_dagtype	STRING	上位のスケジューリングシステムからのインスタンスの実行モード。クライアントはジョブの送信時にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_node_name	STRING	上位のスケジューリングシステムからのノードの名前。クライアントは、ジョブの投入時にこの情報を指定する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_node_onduty	STRING	上位のスケジューリングノードの所有者の ID。クライアントは、ジョブを送信する際にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_node_priority	BIGINT	上位のスケジューリングノードの優先度。クライアントはジョブの送信時にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_node_cyctype	STRING	予約済みのフィールド。クライアントは、ジョブを送信する際にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ext_subtask_id	STRING	上位のスケジューリングノードからのサブタスクの ID。クライアントはジョブの送信時にこの情報を提供する必要があります。詳細については、「ジョブ識別規則」をご参照ください。
ds	STRING	データのアーカイブ日。データは、UTC + 08:00 タイムゾーンにおけるジョブの `start_time` に基づいてアーカイブされます。

TUNNELS_HISTORY

トンネルを介した一括アップロードおよびダウンロード操作の履歴が含まれています。データは 14 日間保持されます。

パラメーター	型	説明
tunnel_catalog	STRING	ターゲットリソースが属するプロジェクト。
tunnel_schema	STRING	ターゲットリソースが属するスキーマ。この値は現在 `NULL` です。
session_id	STRING	セッション ID。
operate_type	STRING	操作タイプ。有効な値： UPLOADLOG DOWNLOADLOG DOWNLOADINSTANCELOG STORAGEAPIREAD STORAGEAPIWRITE
tunnel_type	STRING	トンネルタイプ。有効な値： TUNNEL LOG TUNNEL INSTANCE LOG
request_id	STRING	リクエスト ID。
object_type	STRING	ターゲットオブジェクトのタイプ。有効な値： table instance
object_name	STRING	オブジェクトの名前。テーブル名またはインスタンス ID のいずれかです。
partition_spec	STRING	パーティションテーブルに対する操作のパーティション仕様です。例: `time=20130222, loc=beijing`。
data_size	BIGINT	データのサイズ (バイト単位)。
block_id	BIGINT	トンネルアップロードのブロック ID。このフィールドは、操作タイプが `UPLOADLOG` の場合にのみ入力されます。
offset	BIGINT	ダウンロードの 0 から始まる開始レコード。
length	BIGINT	アップロードまたはダウンロードされたレコードの数。ダウンロードの場合、この値は指定された `length` パラメーターに対応します。
owner_id	STRING	オペレーターの Alibaba Cloud アカウント ID。
owner_name	STRING	オペレーターの Alibaba Cloud アカウント名。
start_time	DATETIME	リクエストの開始時刻。
end_time	DATETIME	リクエストの終了時刻。
client_ip	STRING	トンネルリクエストを行うために使用されたクライアント IP アドレス。
user_agent	STRING	トンネルリクエストを行ったクライアントのユーザーエージェント文字列。たとえば、Java のバージョンやオペレーティングシステムが含まれる場合があります。
columns	STRING	ダウンロード操作で指定された列。
quota_name	STRING	トンネルクォータグループ名。
app_tag	STRING	ユーザー定義のタグ。
ds	STRING	データ収集の日付。例: `ds=20190101`。データは、UTC + 08:00 タイムゾーンでのリクエストの `start_time` の日付に基づいてアーカイブされます。

UDF_PRIVILEGES

このビューは、各プロジェクトの UDF 権限をリストします。

列	型	値
udf_catalog	STRING	UDF を含むプロジェクトの名前。
udf_schema	STRING	UDF を含むスキーマの名前。
udf_name	STRING	UDF 名。
user_catalog	STRING	被付与者のプロジェクトの名前。
user_name	STRING	被付与者の名前。
user_id	STRING	被付与者 ID。
grantor	STRING	付与者。これは予約済みのフィールドです。
privilege_type	STRING	権限のタイプ。

UDFs

各プロジェクトの UDF に関する情報を提供します。

パラメーター	型	値
udf_catalog	STRING	UDF を含むプロジェクトの名前。
udf_schema	STRING	UDF を含むスキーマ。値は現在 NULL です。
udf_name	STRING	UDF の名前。
owner_id	STRING	UDF 所有者の ID。
owner_name	STRING	UDF 所有者の Alibaba Cloud アカウント名。
create_time	DATETIME	UDF の作成時間。
last_modified_time	DATETIME	UDF の最終変更時間。

UDF_RESOURCES

このビューは、各プロジェクトのユーザー定義関数 (UDF) のリソース依存関係をリストします。

パラメーター	型	値
udf_catalog	STRING	UDF を含むプロジェクトの名前。
udf_schema	STRING	UDF を含むスキーマ。
udf_name	STRING	UDF の名前。
resource_catalog	STRING	リソースを含むプロジェクトの名前。
resource_schema	STRING	リソースを含むスキーマ。
resource_name	STRING	リソースの名前。

Users

ユーザーのリスト。

パラメーター	型	値
user_catalog	STRING	ユーザーのプロジェクトの名前。`NULL` の値はテナントレベルのユーザーを示します。
identity_provider	STRING	アカウントタイプ。有効な値： `ALIYUN`：Alibaba Cloud アカウント。 `RAM`：RAM ユーザー。 `RAMRole`：RAM ロール。
user_name	STRING	ユーザー名。
user_id	STRING	ユーザー ID。
user_label	STRING	ユーザーラベル。

ユーザーロール

各ユーザーに割り当てられたロールをリストします。

パラメーター	型	説明
user_role_catalog	STRING	ロールが存在するプロジェクトの名前。null 値はテナントレベルのロールを示します。
role_name	STRING	ロールの名前。
user_name	STRING	ユーザーの名前。
user_id	STRING	ユーザーの ID。

Schemas

このビューは、各プロジェクトのスキーマに関する情報を提供します。

フィールド	型	値
schema_catalog	STRING	スキーマを含むプロジェクトの名前。
schema_name	STRING	スキーマの名前。
owner_id	STRING	スキーマ所有者の Alibaba Cloud アカウント ID。
owner_name	STRING	スキーマ所有者の Alibaba Cloud アカウント名。
create_time	DATETIME	スキーマが作成された時間。
last_modified_time	DATETIME	スキーマが最後に変更された時間。
schema_type	STRING	スキーマのタイプ。
comment	STRING	スキーマのコメント。

クォータ使用量

サブスクリプションコンピューティングクォータのリソース使用量のリアルタイムスナップショットを提供します。このビューを使用して、コンピューティングリソースの消費量を監視します。

パラメーター	型	説明
name	STRING	クォータの名前。
create_time	DATETIME	クォータの作成時間。
last_modified_time	DATETIME	クォータの最終変更時間。
cpu_elastic_quota_max	BIGINT	最大エラスティック CPU クォータ。単位: `core*100`。
cpu_elastic_quota_min	BIGINT	弾力的な CPU の最小クォータ。単位: `core*100`。
cpu_elastic_quota_used	BIGINT	エラスティック CPU クォータの現在の使用量。単位: `core*100`。
mem_elastic_quota_max	BIGINT	弾力的なメモリの最大クォータ。単位： `MB`。
mem_elastic_quota_min	BIGINT	最小エラスティックメモリクォータ。単位： `MB`。
mem_elastic_quota_used	BIGINT	エラスティックメモリクォータの現在の使用量です。単位：`MB`。
cpu_adhoc_quota	BIGINT	アドホック CPU クォータ。単位：`core*100`。
cpu_adhoc_quota_used	BIGINT	アドホック CPU クォータの現在の使用量です。単位： `core*100`。
mem_adhoc_quota	BIGINT	アドホックメモリクォータ。単位：`MB`。
mem_adhoc_quota_used	BIGINT	アドホックメモリクォータの現在の使用量です。単位： `MB`。
cpu_quota_max	BIGINT	予約済みの最大 CPU クォータ。単位：`core*100`。
cpu_quota_min	BIGINT	予約される CPU クォータの最小値です。単位は `core*100` です。
cpu_quota_used	BIGINT	予約済みの CPU クォータの現在の使用量。単位：`core*100`。
mem_quota_max	BIGINT	予約済みの最大メモリクォータ。単位は `MB` です。
mem_quota_min	BIGINT	予約済みの最小メモリクォータです。単位は `MB` です。
mem_quota_used	BIGINT	予約済みメモリクォータの現在の使用量です。単位は `MB` です。
region	STRING	リソースのリージョンです。

Volumes

VOLUMES ビューには、MaxCompute ボリュームに関するメタデータが含まれています。このビューのデータには約 3 時間の遅延があります。

パラメーター	型	説明
volume_catalog	STRING	ボリュームが存在するプロジェクトの名前。
volume_name	STRING	ボリュームの名前。
volume_type	STRING	ボリュームのタイプ。有効な値： INTERNAL EXTERNAL
owner_id	STRING	ボリューム所有者の ID。
owner_name	STRING	ボリュームを所有する Alibaba Cloud アカウントの名前。
create_time	DATETIME	ボリュームの作成時間。
last_modified_time	DATETIME	ボリューム内のデータの最終変更時間。
location	STRING	ボリュームのストレージ場所。
comment	STRING	ボリュームのコメント。
storage_provider	STRING	ボリュームのストレージプロバイダー。
role_arn	STRING	ボリュームのストレージにアクセスするためのロール ARN。
lifecycle	BIGINT	ボリュームのライフサイクル (日数)。
options	STRING	ボリュームの構成オプション。

FOREIGN_SERVERS

このビューには、MaxCompute の外部サーバーに関するメタデータが含まれています。データには約 3 時間の遅延があります。

パラメーター	型	値
server_name	STRING	外部サーバーの名前。
server_type	STRING	外部サーバーのタイプ。
owner_id	STRING	外部サーバーの所有者の ID。
owner_name	STRING	外部サーバーを所有する Alibaba Cloud アカウントの名前。
create_time	DATETIME	外部サーバーの作成時間。
last_modified_time	DATETIME	外部サーバーが最後に変更された時間。
options	STRING	外部サーバーの構成オプション。