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

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

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

리소스 이름 지정 형식

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

리소스 전체 리소스 이름 형식
항목 그룹 projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}
항목 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

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

위치

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

리소스 ID

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

표준 리소스 ID

항목 ID(및 데이터 계보 리소스 ID(를 제외한 모든 리소스 ID 변수(예: {ENTRY_GROUP_ID} 및 {GLOSSARY_ID})는 다음 가이드라인을 준수해야 합니다.

  • 소문자로 시작해야 합니다.
  • 1~63자의 문자를 포함해야 합니다.
  • 소문자, 숫자, 하이픈, 밑줄만 포함해야 합니다.
  • 숫자 또는 소문자로 끝나야 합니다.

시스템 항목 그룹

항목 ID

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

  • 최대 4,000자를 포함합니다.

  • 전체 리소스 이름을 기반으로 항목 ID 형식을 사용합니다. Google Cloud 형식은 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 항목 이름

Knowledge Catalog 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