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 KEYFOREIGN 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 |
    +-----------------------------+