SCHEMATA_LINKS 뷰

INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰에는 연결된 데이터 세트마다 행이 하나씩 포함됩니다. 연결된 데이터 세트는 현재 사용자가 액세스할 수 있는 프로젝트의 공유 데이터 세트에 연결됩니다.

필요한 권한

INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 쿼리하려면 프로젝트 수준의 bigquery.datasets.get Identity and Access Management(IAM) 권한이 필요합니다.

사전 정의된 다음 각 IAM 역할에는 INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 쿼리하는 데 필요한 권한이 포함되어 있습니다.

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

BigQuery 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

스키마

INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰에는 다음과 같은 스키마가 있습니다.

열 이름 데이터 유형 값
CATALOG_NAME STRING 데이터 세트가 포함된 프로젝트 이름입니다.
SCHEMA_NAME STRING 소스 데이터 세트의 이름입니다. 데이터 세트 이름은 datasetId라고도 합니다.
LINKED_SCHEMA_CATALOG_NUMBER STRING 연결된 데이터 세트가 포함된 프로젝트의 프로젝트 번호입니다.
LINKED_SCHEMA_CATALOG_NAME STRING 연결된 데이터 세트가 포함된 프로젝트의 프로젝트 이름입니다.
LINKED_SCHEMA_NAME STRING 연결된 데이터 세트의 이름입니다. 데이터 세트 이름은 datasetId라고도 합니다.
LINKED_SCHEMA_CREATION_TIME TIMESTAMP 연결된 데이터 세트가 생성된 시간입니다.
LINKED_SCHEMA_ORG_DISPLAY_NAME STRING 연결된 데이터 세트가 생성되는 조직의 표시 이름입니다.

범위 및 구문

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 리전 한정자를 지정하지 않으면 미국 리전에서 메타데이터가 검색됩니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS 프로젝트 수준 미국 리전
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS 프로젝트 수준 REGION
다음을 바꿉니다.

  • (선택사항) PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 region-us입니다.

예시

이 섹션에는 INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 쿼리하기 위한 예시가 나와 있습니다.

예시: 다른 프로젝트에 연결된 모든 데이터 세트 나열

다음 예시는 eu 리전 내의 otherproject라는 다른 프로젝트와 연결된 모든 데이터 세트를 나열합니다.

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

출력은 다음과 비슷합니다. 출력을 간소화하기 위해 일부 열을 생략합니다.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

예시: 공유 데이터 세트를 기준으로 연결된 모든 데이터 세트 나열

다음 예시는 US 멀티 리전의 sharedataset라는 공유 데이터 세트로 연결된 모든 데이터세트를 나열합니다.

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

출력은 다음과 비슷합니다. 출력을 간소화하기 위해 일부 열을 생략합니다.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | sharedataset| subscriptionproject1       |                 674999999291 | subscriptionld1    | subscriptionorg1               |
| myproject      | sharedataset| subscriptionproject2       |                 774999999292 | subscriptionld2    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+