Knowledge Catalog 리소스 이름 지정 가이드라인

Google Cloud 리소스는Google Cloud내에서 만들거나 사용하는 모든 구성요소입니다. 이러한 리소스는 플랫폼에서 실행되는 애플리케이션과 시스템의 빌딩 블록을 형성합니다.

일반적인 Google Cloud 리소스 이름 지정에 대한 자세한 내용은 리소스 이름을 참조하세요.

리소스 이름 지정 형식

다음 표에는 Knowledge Catalog 리소스의 전체 리소스 이름 형식이 나와 있습니다.

리소스 전체 리소스 이름 형식
항목 그룹 projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}
Entry projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}
항목 유형 projects/{PROJECT_ID}/locations/{LOCATION}/entryTypes/{ENTRY_TYPE_ID}
관점 유형 projects/{PROJECT_ID}/locations/{LOCATION}/aspectTypes/{ASPECT_TYPE_ID}
항목 링크 projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}
메타데이터 작업 projects/{PROJECT_ID}/locations/{LOCATION}/metadataJobs/{METADATA_JOB_ID}
메타데이터 피드 projects/{PROJECT_ID}/locations/{LOCATION}/metadataFeeds/{METADATA_FEED_ID}
용어집 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}
용어집 카테고리 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}
용어집 용어 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}
데이터 제품 projects/{PROJECT_ID}/locations/{LOCATION}/dataProducts/{DATA_PRODUCT_ID}
데이터 도메인 projects/{PROJECT_ID}/locations/{LOCATION}/dataDomains/{DATA_DOMAIN_ID}
계보 프로세스 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}
계보 실행 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}
계보 이벤트 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

리소스 이름 구성요소

다음 섹션에서는 각 구성요소를 자세히 설명합니다.

프로젝트 ID

값은 Google Cloud 콘솔에서 사용할 수 있는 프로젝트 ID 또는 프로젝트 번호여야 합니다. 예를 들어 my-cool-project는 프로젝트 ID이고 123456789123는 프로젝트 번호입니다.

위치

값은 지원되는 Knowledge Catalog 위치 중 하나여야 합니다. 사용 가능한 위치 목록은 Knowledge Catalog 위치를 참조하세요.

리소스 ID

리소스 경로에는 계층 구조의 각 리소스와 상위 리소스에 대한 고유 식별자 (ID) 세그먼트가 포함됩니다. 다음 섹션에서는 각 유형의 리소스 ID에 대한 이름 지정 가이드라인과 형식 요구사항을 설명합니다.

표준 리소스 ID

항목 ID 및 데이터 계보 리소스 ID를 제외하고 {ENTRY_GROUP_ID} 및 {GLOSSARY_ID}와 같은 모든 리소스 ID 변수는 다음 가이드라인을 준수해야 합니다.

  • 소문자로 시작해야 합니다.
  • 1~63자(영문 기준)여야 합니다.
  • 소문자, 숫자, 하이픈, 밑줄만 포함해야 합니다.
  • 숫자 또는 소문자로 끝나야 합니다.

시스템 항목 그룹

항목 ID

{ENTRY_ID}의 이름 지정 가이드라인은 다릅니다.

  • 최대 4,000자(영문 기준)까지 포함할 수 있습니다.

  • Google Cloud 전체 리소스 이름을 기반으로 하는 항목 ID 형식을 사용합니다. 형식은 API 서비스 이름 부분에 이중 슬래시 프리픽스가 없는 리소스의 전체 리소스 이름입니다. 이렇게 하면 연결된 리소스 이름을 사용하여 항목을 검색할 수 있습니다.

    예를 들면 다음과 같습니다.

    • Looker 인스턴스의 전체 리소스 이름이 //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance인 경우 추천 {ENTRY_ID}는 looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance입니다.

데이터 계보 리소스 ID

데이터 계보 리소스는 데이터 변환 작업의 계층 구조를 나타냅니다.

  • 프로세스 ID ({PROCESS_ID}): 데이터 변환 정의를 식별합니다 (예: 특정 SQL 쿼리 또는 ETL 파이프라인).
  • 실행 ID ({RUN_ID}): 상위 프로세스의 단일 실행 인스턴스를 식별합니다.
  • 계보 이벤트 ID ({LINEAGE_EVENT_ID}): 실행 중에 발생한 소스와 타겟 간의 개별 데이터 이동 이벤트를 식별합니다.

API를 통해 커스텀 계보 리소스를 만들 때 {PROCESS_ID}, {RUN_ID}, {LINEAGE_EVENT_ID} 변수는 다음 가이드라인을 준수해야 합니다.

  • 최대 200자(영문 기준)까지 포함할 수 있습니다.
  • 문자 (대소문자 구분), 숫자, 하이픈, 밑줄, 콜론, 마침표만 포함합니다.

자동화된 계보 (예: BigQuery 쿼리, Managed Service for Apache Spark 또는 OpenLineage 수집)의 경우 Knowledge Catalog에서 이러한 ID를 자동으로 생성합니다.

BigQuery 항목 이름

Dataplex API를 통해 BigQuery 리소스와 상호작용할 때는 항목 그룹 ID와 항목 ID에 특정 형식을 사용해야 합니다.

  • 항목 그룹 ID: @bigquery
  • 항목 ID: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

예

BigQuery 테이블이 projects/test-project/datasets/test_dataset/tables/test_table인 경우 정규화된 Knowledge Catalog 항목 이름은 다음과 같습니다.

projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table