TABLE_CONSTRAINTS ビュー

TABLE_CONSTRAINTS ビューには、BigQuery データセット内の主キーと外部キーの関係が含まれます。

必要な権限

次の Identity and Access Management（IAM）権限が必要です。

  • bigquery.tables.get: 主キーと外部キーの定義を表示します。
  • bigquery.tables.list: テーブル情報スキーマを表示します。

次の各事前定義ロールには、このドキュメントで説明するワークフローの実行に必要な権限があります。

  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.admin

BigQuery での IAM のロールと権限について詳しくは、事前定義ロールと権限をご覧ください。

スキーマ

INFORMATION_SCHEMA.TABLE_CONSTRAINTS ビューのスキーマは次のとおりです。

列名 型 意味

CONSTRAINT_CATALOG

STRING

制約プロジェクト名。

CONSTRAINT_SCHEMA

STRING

制約データセット名。

CONSTRAINT_NAME

STRING

制約名。

TABLE_CATALOG

STRING

制約付きテーブルのプロジェクト名。

TABLE_SCHEMA

STRING

制約付きテーブルのデータセット名。

TABLE_NAME

STRING

制約付きテーブルの名前。

CONSTRAINT_TYPE

STRING

PRIMARY KEY、FOREIGN KEY のいずれか。

IS_DEFERRABLE

STRING

YES または NO（制約が延期可能かどうかによる）。NO のみがサポートされています。

INITIALLY_DEFERRED

STRING

NO のみがサポートされています。

ENFORCED

STRING

YES または NO（制約が適用されているかどうかによる）。
NO のみがサポートされています。

スコープと構文

このビューに対するクエリでは、データセット修飾子を指定する必要があります。データセット修飾子が指定されたクエリの場合は、データセットに対する権限が必要です。詳細については、構文をご覧ください。次の表に、このビューのリージョン スコープとリソース スコープを示します。

ビュー名 リソース スコープ リージョン スコープ
[PROJECT_ID.]DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS; データセット レベル データセットのロケーション
次のように置き換えます。
  • 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。

例

次のクエリは、データセット内の単一テーブルの制約を示します。

SELECT *
FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS
WHERE table_name = TABLE;

次のように置き換えます。

  • PROJECT_ID: 省略可。クラウド プロジェクトの名前。指定しない場合、このコマンドではデフォルトのプロジェクトが使用されます。
  • DATASET: データセット名。
  • TABLE: テーブルの名前。

次のクエリは逆に、単一データセット内のすべてのテーブルの制約を示します。

SELECT *
FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS;

既存の制約を使用すると、クエリ結果は次のようになります。

+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
| Row | constraint_catalog  | constraint_schema |    constraint_name    |    table_catalog    | table_schema | table_name | constraint_type | is_deferrable | initially_deferred | enforced |
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
|   1 | myConstraintCatalog | myDataset         | orders.pk$            | myConstraintCatalog | myDataset    | orders     | PRIMARY KEY     | NO            | NO                 | NO       |
|   2 | myConstraintCatalog | myDataset         | orders.order_customer | myConstraintCatalog | myDataset    | orders     | FOREIGN KEY     | NO            | NO                 | NO       |
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+

テーブルまたはデータセットに制約がない場合、クエリ結果は次のようになります。

+-----------------------------+
| There is no data to display |
+-----------------------------+