PROPERTY_GRAPHS 뷰

INFORMATION_SCHEMA.PROPERTY_GRAPHS 뷰에는 지정한 데이터 세트 또는 리전의 각 속성 그래프에 대해 하나의 행이 포함됩니다.

필수 권한

INFORMATION_SCHEMA.PROPERTY_GRAPHS 뷰를 쿼리하려면 관리자에게 다음 사전 정의된 IAM 역할 중 하나를 부여해 달라고 요청하세요.

  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer
  • roles/bigquery.admin

스키마

INFORMATION_SCHEMA.PROPERTY_GRAPHS 뷰를 쿼리하면 지정한 리소스 범위의 각 속성 그래프에 대해 하나의 행이 쿼리 결과에 포함됩니다.

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

열 이름 데이터 유형 값
property_graph_catalog STRING 속성 그래프가 정의된 데이터 세트가 포함된 프로젝트의 이름입니다.
property_graph_schema STRING 속성 그래프가 포함된 데이터 세트의 이름입니다.
property_graph_name STRING 속성 그래프 이름입니다.
property_graph_metadata_json STRING 속성 그래프 정의의 JSON 표현입니다. 이 표현에는 그래프의 노드, 가장자리, 라벨, 속성, 생성 타임스탬프, 수정 타임스탬프와 같은 그래프에 대한 정보가 포함되어 있습니다.
ddl STRING 속성 그래프를 만드는 데 사용할 수 있는 DDL 문입니다.

범위 및 구문

이 뷰에 대한 쿼리에는 데이터 세트나 리전 한정자가 포함되어야 합니다. 데이터 세트 한정자가 있는 쿼리에는 데이터 세트에 대한 권한이 있어야 합니다. 리전 한정자가 있는 쿼리에는 프로젝트에 대한 권한이 있어야 합니다. 자세한 내용은 구문을 참조하세요. 다음 표에서는 이 뷰의 리전 범위와 리소스 범위를 설명합니다.

뷰 이름 리소스 범위 리전 범위
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS 프로젝트 수준 REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS 데이터 세트 수준 데이터 세트 위치
다음을 바꿉니다.
  • 선택사항: PROJECT_ID: Google Cloud 프로젝트의 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.
  • REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면 `region-us`입니다.
  • DATASET_ID: 데이터 세트의 ID입니다. 자세한 내용은 데이터 세트 한정자를 참조하세요.

예

다음 예시에서는 INFORMATION_SCHEMA.PROPERTY_GRAPHS 뷰에서 property_graph_name, property_graph_metadata_json, ddl 열을 검색합니다.

SELECT
  property_graph_name, property_graph_metadata_json, ddl
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS;

결과는 다음과 비슷합니다.

+---------------------+------------------------------------------------+------------------------------------------------------+
| property_graph_name | property_graph_metadata_json                   | ddl                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+
| FinGraph            | {"creationTime":"2026-01-05T22:22:22.365394Z", | CREATE PROPERTY GRAPH `my_project.graph_db.FinGraph` |
|                     | "edgeTables":[{"dataSourceTable":{"datasetId": | NODE TABLES (`my_project.graph_db.Account` AS        |
|                     | "graph_db","projectId":"my_project","tableId   | Account KEY (id)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+