SCHEMATA_LINKS 뷰
INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰에는 BigQuery 공유를 사용하여 공유된 각 연결된 데이터 세트마다 행이 하나씩 포함됩니다. 이 뷰에는 데이터 클린룸을 사용하여 공유되는 프로젝트의 테이블 또는 뷰와 같은 개별 리소스도 포함됩니다. 이 뷰에는 연결된 데이터 세트의 각 개별 리소스에 대한 행이 하나씩 표시됩니다.
필요한 권한
INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 쿼리하려면 프로젝트 수준의 bigquery.datasets.get Identity and Access Management(IAM) 권한이 필요합니다.
사전 정의된 다음 각 IAM 역할에는 INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 쿼리하는 데 필요한 권한이 포함되어 있습니다.
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/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
|
연결된 데이터 세트가 생성되는 조직의 표시 이름입니다. |
shared_asset_id
|
STRING
|
데이터 클린룸을 사용하여 공유되는 애셋의 ID입니다. link_type이 REGULAR인 경우 이 값은 null입니다.
|
link_type
|
STRING
|
연결된 데이터 세트의 유형입니다. 가능한 값은 REGULAR 또는 DCR (데이터 클린룸)입니다.
|
범위 및 구문
이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 리전 한정자를 지정하지 않으면 미국 리전에서 메타데이터가 검색됩니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.
| 뷰 이름 | 리소스 범위 | 리전 범위 |
|---|---|---|
[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 | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | otherproject | source_dataset | subscriptioproject1 | 974999999291 | linked_dataset | subscriptionorg1 | 2025-08-07 05:02:27 | NULL | REGULAR | | otherproject | source_dataset1 | subscriptionproject2 | 974999999292 | test_dcr | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
예시: 공유 데이터 세트를 기준으로 연결된 모든 데이터 세트 나열
다음 예시는 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 | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | myproject | sharedataset | subscriptionproject1 | 974999999291 | linked_dataset | subscriptionorg1 | 2025-08-07 05:02:27 | NULL | REGULAR | | myproject | sharedataset | subscriptionproject2 | 974999999292 | test_dcr | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
예: 데이터 클린룸을 사용하여 공유된 모든 리소스 나열
다음 예시는 EU 멀티 리전 내의 otherproject라는 다른 프로젝트에서 데이터 클린룸을 사용하여 공유되는 테이블이나 뷰와 같은 모든 개별 리소스를 나열합니다.
SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';
출력은 다음과 비슷합니다. 출력을 간소화하기 위해 일부 열을 생략합니다.
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | catalog_name | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+ | otherproject | sharedataset1 | subscriptionproject1 | 974999999291 | test_dcr1 | subscriptionorg1 | 2025-08-07 05:02:27 | test_view | DCR | | otherproject | sharedataset2 | subscriptionproject2 | 974999999292 | test_dcr2 | subscriptionorg2 | 2025-08-07 10:08:50 | test_table | DCR | +---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+