이 페이지는 Cloud Translation API를 통해 번역되었습니다.

비즈니스 용어집 관리하기

Dataplex 범용 카탈로그 비즈니스 용어집은 회사 전체의 비즈니스 관련 용어 및 정의를 한 곳에서 관리할 수 있는 기능을 제공합니다.

여러 팀이 공유 프로젝트에서 작업하거나 대기업에 부서가 많은 경우 기업의 각 부분에서 작업하는 다양한 데이터 리소스를 설명하기 위해 자체 용어를 만드는 것이 일반적입니다. 이로 인해 커뮤니케이션 오류가 발생하고 이러한 리소스에 대한 이해가 일관되지 않을 수 있습니다. 또한 개념에 기술적 또는 전문 지식이 필요한 경우도 있습니다. 이로 인해 다른 도메인의 비즈니스 사용자가 개념을 이해하기 어려울 수 있습니다.

Dataplex 범용 카탈로그 비즈니스 용어집을 사용하면 데이터 리소스의 중앙 표준화된 어휘를 만들 수 있습니다. 비즈니스 용어집을 사용하여 다음 작업을 할 수 있습니다.

비즈니스 카테고리 및 개념의 계층 구조를 정의합니다. 이를 용어라고 합니다.
동의어와 관련 용어를 정의하여 개념 간의 연결을 만듭니다.
데이터 리소스를 용어집의 용어와 연결하여 비즈니스 개념을 기반으로 데이터 리소스를 검색할 수 있습니다.

비즈니스 용어집은 데이터 검색을 간소화하고 모호성을 줄여 더 정확한 분석, 더 나은 거버넌스, 더 빠른 통계로 이어질 수 있습니다.

비즈니스 용어집의 요소

이 섹션에서는 비즈니스 용어집을 구성하는 데 사용할 수 있는 주요 요소를 설명합니다.

용어집

용어집에는 다음과 같은 속성이 있습니다.

개요. 비즈니스 용어집의 목적과 내용을 설명합니다. 용어집에 이미지, 링크, 표 또는 서식이 지정된 텍스트를 추가할 수 있습니다. 지원되는 최대 크기는 120KB입니다.
설명. 용어집을 설명합니다. 이 필드의 텍스트는 검색을 위해 색인이 생성됩니다. 지원되는 최대 크기는 1KB입니다.
Region 사용). 용어가 있는 리전을 지정합니다.

용어

용어('용어집 용어'의 약자)는 회사 내 특정 비즈니스 분야에서 사용되는 개념을 설명합니다. 예를 들어 회사의 마케팅 부서에서 클릭당비용을 설명하는 용어를 만들 수 있습니다. 용어는 용어집의 비즈니스 용어 내에서 직접 또는 용어집에서 찾을 수 있는 카테고리 내에서 정의됩니다.

용어에는 카테고리의 속성과 다음 속성이 있습니다.

동의어 의미가 동일한 용어 간의 링크를 지정합니다. 동의어를 참고하세요.
관련 용어. 개념적으로 서로 관련이 있지만 의미가 다른 용어 간의 링크를 지정합니다. 관련 용어를 참고하세요.
관련 항목 용어와 데이터 애셋 간 또는 용어와 데이터 애셋 내 열 간의 링크를 지정합니다.
연락처. 용어 유지보수 담당자를 지정합니다. 용어는 카테고리에 정의된 연락처를 상속하지 않습니다.

용어의 리전은 용어가 포함된 용어집의 리전과 동일합니다.

동의어 용어

동의어는 서로 다른 두 용어 간의 등가를 나타내는 관계입니다. 용어집이 서로 다른 팀에서 의미가 동일한 두 용어를 정의하는 경우 동의어를 사용합니다. 예를 들어 '이익'과 '수익'이라는 용어를 연결하는 동의어를 만들 수 있습니다.

관련 용어는 두 용어가 서로 관련이 있지만 의미가 다름을 나타내는 관계입니다. 예를 들어 '수익'과 '이익'이라는 용어를 연결하는 관련 용어를 만들 수 있습니다.

제한사항

Assured Workload 프로젝트에는 Dataplex 범용 카탈로그 비즈니스 용어집이 지원되지 않습니다.
비즈니스 용어집은 프로젝트 및 위치 내에 있으며 프로젝트 및 위치 제한사항이 용어집에 적용됩니다.

필요한 역할

용어집을 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

데이터 관리자의 경우 용어집, 카테고리, 용어, 동의어, 관련 용어에 대한 전체 액세스 권한을 얻고 IAM 정책을 설정합니다. Dataplex 카탈로그 관리자 (roles/dataplex.catalogAdmin)
데이터 관리자 또는 데이터 소유자는 용어집, 카테고리, 용어, 용어 간 링크, 용어와 데이터 애셋 간 링크를 만들거나 수정하거나 삭제하고 검색할 수 있습니다. Dataplex 카탈로그 편집자 (roles/dataplex.catalogEditor)
데이터 분석가 또는 데이터 소비자의 경우 용어집, 카테고리, 용어, 용어 간 링크, 용어와 데이터 애셋 간 링크에 대한 읽기 전용 액세스 권한을 얻고 검색합니다. Dataplex 카탈로그 뷰어 (roles/dataplex.catalogViewer)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 용어집을 만들고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

용어집을 만들고 관리하려면 다음 권한이 필요합니다.

프로젝트에서 비즈니스 용어집, 카테고리, 용어를 생성, 읽기, 업데이트, 삭제합니다.
- dataplex.glossaries.list
- dataplex.glossaries.create
- dataplex.glossaries.get
- dataplex.glossaries.update
- dataplex.glossaries.delete
- dataplex.glossaryCategories.create
- dataplex.glossaryCategories.list
- dataplex.glossaryCategories.get
- dataplex.glossaryCategories.update
- dataplex.glossaryCategories.delete
- dataplex.glossaryTerms.create
- dataplex.glossaryTerms.list
- dataplex.glossaryTerms.get
- dataplex.glossaryTerms.update
- dataplex.glossaryTerms.delete
프로젝트에서 동의어 term-to-term 링크를 만들고 삭제합니다.
- dataplex.entryLinks.create 용어집 용어가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다. 링크는 권한이 부여된 항목 그룹에 생성됩니다.
- dataplex.entryGroups.useSynonymEntryLink 용어집 용어가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다. 링크는 권한이 부여된 항목 그룹에 생성됩니다.
- dataplex.glossaryTerms.use 용어를 연결해야 하는 용어집에 대한 액세스 권한이 있어야 합니다.
- dataplex.entryLinks.delete 링크가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다.
프로젝트에서 관련 용어 간 링크를 만들고 삭제합니다.
- dataplex.entryLinks.create 용어집 용어가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다. 링크는 권한이 부여된 항목 그룹에 생성됩니다.
- dataplex.entryGroups.useRelatedEntryLink 용어집 용어가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다. 링크는 권한이 부여된 항목 그룹에 생성됩니다.
- dataplex.entries.link 용어집 용어에 해당하는 항목이 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다.
- dataplex.entryLinks.delete 링크가 있는 프로젝트의 Dataplex 범용 카탈로그 항목 그룹에 대한 권한이 있어야 합니다.
프로젝트의 용어와 데이터 애셋 또는 열 간에 연결을 만듭니다.
- dataplex.entryLinks.create 프로젝트의 데이터 애셋 또는 열에 해당하는 시스템 항목 그룹에 대한 액세스 권한이 있어야 합니다. 링크는 권한이 부여된 프로젝트에 생성됩니다.
- dataplex.entryGroups.useDefinitionEntryLink 프로젝트의 데이터 애셋 또는 열에 해당하는 시스템 항목 그룹에 대한 액세스 권한이 있어야 합니다. 링크는 권한이 부여된 프로젝트에 생성됩니다.
- dataplex.entries.link on the system entry group corresponding to data assets or columns in the project. 링크는 권한이 부여된 프로젝트에 생성됩니다.
- dataplex.glossaryTerms.use 용어를 연결해야 하는 용어집에 있습니다.
- dataplex.entryLinks.delete 링크가 있는 시스템 항목 그룹에 대한 액세스 권한이 있어야 합니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

자세한 내용은 Data Catalog의 사전 정의된 역할을 참조하세요.

비즈니스 용어집 만들기 및 관리

다음 섹션에서는 비즈니스 용어를 만들고, 보고, 수정하고, 삭제하는 방법을 설명합니다.

비즈니스 용어집 만들기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
비즈니스 용어집 만들기를 클릭합니다.
비즈니스 용어집 만들기 페이지에서 비즈니스 용어집의 이름과 위치를 지정합니다. 용어집을 만든 후에는 위치를 변경할 수 없습니다.
만들기를 클릭합니다. 용어집이 현재 프로젝트에 생성됩니다.
선택사항: 설명 (최대 1,024자)에 간단한 설명을 추가하거나 개요 (최대 120KB)에 긴 설명을 추가합니다.

REST

용어집을 만들면 Dataplex 범용 카탈로그에서 용어집을 나타내는 항목을 만듭니다.

용어집을 만듭니다.

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

다음을 바꿉니다.

PROJECT_ID: 용어집을 만들려는 프로젝트의 ID입니다.
LOCATION_ID: 용어집을 만들 위치의 ID입니다.
GLOSSARY_ID: 용어집의 ID
DISPLAY_NAME: 용어집의 표시 이름
DESCRIPTION: 용어집에 대한 설명입니다(최대 1,024자).

선택사항: 용어집에 개요를 추가합니다.

용어집 항목을 조회합니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
\
\&view=ALL

PROJECT_NUMBER를 용어집이 생성된 프로젝트의 번호로 바꿉니다.

용어집에 개요를 추가합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
--data @- << EOF
{
"aspects": {
   "dataplex-types.global.overview": {
      "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
      "data": {
      "content": "OVERVIEW",
      "links": []
      },
   }
}
}
EOF

OVERVIEW을 일반 텍스트 또는 HTML로 바꿔 용어집 카테고리 또는 용어를 설명합니다.

사용 가능한 용어집 보기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동

내 용어집 창에는 내게 조회 권한이 있는 모든 조직 용어집이 설명 및 마지막 수정 타임스탬프와 함께 표시됩니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

용어집 수정

용어집의 이름과 설명을 수정할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
수정할 용어집을 클릭합니다.
이름, 설명 또는 개요 옆에 있는 수정을 클릭한 다음 변경합니다.
저장을 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

용어집 삭제

용어집을 삭제하려면 먼저 용어집의 모든 카테고리와 용어를 삭제해야 합니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
삭제할 용어집을 클릭합니다.
삭제를 클릭한 후 메시지가 표시되면 확인합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

카테고리 만들기 및 관리

다음 섹션에서는 카테고리를 만들고, 보고, 업데이트하고, 삭제하는 방법을 설명합니다.

용어집 아래에 카테고리 만들기

비즈니스 용어집에는 최대 200개의 카테고리가 있을 수 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
카테고리를 만들려는 용어집을 선택한 다음 카테고리 만들기를 클릭합니다.
카테고리 이름을 입력합니다.
만들기를 클릭합니다.
선택사항: 설명 (최대 1,024자)에 간단한 설명을 추가하거나 개요 (최대 120KB)에 긴 설명을 추가합니다.

REST

카테고리를 만들면 Dataplex 범용 카탈로그에서 카테고리를 나타내는 항목을 만듭니다.

카테고리를 만듭니다.

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "CATEGORY_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

다음을 바꿉니다.

CATEGORY_ID: 카테고리 ID
CATEGORY_DISPLAY_NAME: 카테고리 표시 이름
CATEGORY_DESCRIPTION: 카테고리 설명

선택사항: 카테고리에 개요를 추가합니다.

카테고리 항목을 찾습니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

카테고리에 개요를 추가합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

OVERVIEW을 일반 텍스트 또는 HTML로 바꿔 용어집 카테고리 또는 용어를 설명합니다.

선택사항: 연락처 추가

카테고리 항목을 찾습니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

연락처를 사용하여 카테고리 항목을 업데이트합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

중첩된 카테고리 만들기

비즈니스 용어집에는 루트 용어집 수준을 제외하고 최대 3개의 중첩된 카테고리 수준이 있을 수 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
카테고리를 만들려는 용어집을 확장합니다.
다른 카테고리를 만들려는 상위 카테고리를 선택하고 카테고리 만들기를 클릭합니다.
카테고리 이름을 입력합니다.
만들기를 클릭합니다.
선택사항: 설명 (최대 1,024자)에 간단한 설명을 추가하거나 개요 (최대 120KB)에 긴 설명을 추가합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

PARENT_CATEGORY_ID를 상위 카테고리의 ID로 바꿉니다.

용어집에 속한 카테고리 보기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집의 카테고리를 보려면 용어집을 펼칩니다.
카테고리의 중첩된 카테고리를 보려면 카테고리를 펼칩니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

카테고리 수정

카테고리의 이름, 설명, 연락처를 수정할 수 있습니다. 중첩된 카테고리의 경우 상위 카테고리를 수정할 수도 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 수정하려는 카테고리를 클릭합니다.
이름, 설명 또는 개요 옆에 있는 수정을 클릭한 다음 변경합니다.
저장을 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

카테고리 삭제

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 삭제할 카테고리를 클릭합니다.
삭제를 클릭한 후 메시지가 표시되면 확인합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

용어 만들기 및 관리

다음 섹션에서는 용어를 만들고, 보고, 액세스하고, 수정하고, 삭제하는 방법을 설명합니다.

비즈니스 용어집 아래에 용어 만들기

비즈니스 용어집에는 최대 5,000개의 용어가 포함될 수 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집 수준에서 용어를 만들려면 용어를 만들 용어집을 선택한 다음 용어 만들기를 클릭합니다.
용어의 이름을 입력합니다.
만들기를 클릭합니다.
선택사항: 설명 (최대 1,024자)에 간단한 설명을 추가하거나 개요 (최대 120KB)에 긴 설명을 추가합니다.
선택사항: 연락처를 추가하려면 수정을 클릭한 다음 데이터 관리자, 데이터 소유자 또는 데이터 도메인 소유자의 이메일 주소 목록을 제공합니다. 그런 다음 저장을 클릭하고

REST

용어를 만들면 Dataplex 범용 카탈로그에서 용어를 나타내는 항목을 만듭니다.

용어를 만듭니다.

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

다음을 바꿉니다.

TERM_ID: 만들려는 용어의 ID
TERM_DISPLAY_NAME: 만들려는 용어의 표시 이름
TERM_DESCRIPTION: 만들려는 용어에 대한 설명

선택사항: 용어에 개요를 추가합니다.

용어 항목을 조회합니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

용어에 개요를 추가합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

OVERVIEW을 일반 텍스트 또는 HTML로 바꿔 용어집 카테고리 또는 용어를 설명합니다.

선택사항: 연락처를 추가합니다.

용어 항목을 조회합니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

연락처를 사용하여 용어 항목을 업데이트합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

카테고리 아래에 용어 만들기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
카테고리에 용어를 만들려면 용어를 만들 카테고리를 선택한 다음 용어 추가를 클릭합니다.
용어의 이름을 입력합니다.
만들기를 클릭합니다.
선택사항: 설명 (최대 1,024자)에 간단한 설명을 추가하거나 개요 (최대 120KB)에 긴 설명을 추가합니다.
선택사항: 연락처를 추가하려면 수정을 클릭한 다음 데이터 관리자, 데이터 소유자 또는 데이터 도메인 소유자의 이메일 주소 목록을 제공합니다. 그런 다음 저장을 클릭하고

REST

용어를 만들면 Dataplex 범용 카탈로그에서 용어를 나타내는 항목을 만듭니다.

용어를 만듭니다.

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

다음을 바꿉니다.

TERM_ID: 만들려는 용어의 ID
TERM_DISPLAY_NAME: 만들려는 용어의 표시 이름
TERM_DESCRIPTION: 만들려는 용어에 대한 설명

선택사항: 용어에 개요를 추가합니다.

용어 항목을 조회합니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

용어에 개요를 추가합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

OVERVIEW을 일반 텍스트 또는 HTML로 바꿔 용어집 카테고리 또는 용어를 설명합니다.

선택사항: 연락처를 추가합니다.

용어 항목을 조회합니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

연락처를 사용하여 용어 항목을 업데이트합니다.

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

용어집 또는 카테고리에서 용어 보기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집의 용어를 보려면 용어집을 펼칩니다. 이 용어집의 카테고리에 있는 용어를 보려면 카테고리를 펼치세요. 중첩된 카테고리 내의 용어를 보려면 중첩된 카테고리를 펼칩니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

용어 세부정보 보기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집의 용어 목록을 보려면 용어집을 펼칩니다.
용어를 클릭합니다. 용어 세부정보 페이지에는 용어 이름, 설명, 관련 용어, 동의어, 관련 항목이 표시됩니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

용어 수정하기

용어의 이름, 설명, 개요, 연락처, 상위를 수정할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 수정하려는 용어를 클릭합니다.
수정을 클릭합니다.
필드를 수정하고 저장을 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

용어 삭제

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 삭제할 용어를 클릭합니다.
삭제를 클릭한 후 메시지가 표시되면 확인합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

동의어 및 관련 용어 관리

용어를 동의어 또는 관련 용어로 연결하여 용어 간 관계를 추가할 수 있습니다.

용어 관계는 양방향입니다. 예를 들어 profit를 earnings의 동의어로 연결하면 earnings도 profit의 동의어가 됩니다.

용어 간에 동의어 링크 만들기

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 링크를 만들려는 용어를 클릭합니다.
동의어 옆에 있는 수정을 클릭합니다.
링크할 용어를 검색한 다음 선택합니다.

용어를 선택하면 즉시 연결됩니다.
닫기를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

다음을 바꿉니다.

TERM1_PROJECT_NUMBER: 연결되는 첫 번째 약관의 프로젝트 번호입니다.
TERM1_LOCATION_ID: 첫 번째 용어가 포함된 용어집의 위치 ID입니다.
TERM1_GLOSSARY_ID: 첫 번째 용어가 포함된 용어집의 ID입니다.
TERM1_ID: 첫 번째 용어의 ID입니다.
TERM2_PROJECT_NUMBER: 동의어 용어로 연결할 두 번째 용어의 프로젝트 번호입니다. 두 용어가 동일한 프로젝트에 있는 경우 이 값은 첫 번째 용어의 프로젝트 번호와 동일합니다.
TERM2_LOCATION_ID: 두 번째 용어가 포함된 용어집의 위치 ID입니다. 두 용어가 동일한 위치에 있는 경우 이 값은 첫 번째 용어의 위치 ID와 동일합니다.
TERM2_GLOSSARY_ID: 두 번째 용어가 포함된 용어집의 ID입니다. 두 용어가 동일한 용어집에 있는 경우 이 값은 첫 번째 용어의 용어집 ID와 동일합니다.
TERM2_ID: 두 번째 용어의 ID입니다.
ENTRY_LINK_ID: 두 용어 간 링크의 ID입니다. 각 용어는 Dataplex 범용 카탈로그 항목으로 표시됩니다. 항목 링크는 동의어 용어 간의 관계입니다.

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 링크를 만들려는 용어를 클릭합니다.
관련 용어 옆에 있는 수정을 클릭합니다.
링크할 용어를 검색한 다음 선택합니다.

용어를 선택하면 즉시 연결됩니다.
닫기를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

다음을 바꿉니다.

TERM1_PROJECT_NUMBER: 연결되는 첫 번째 약관의 프로젝트 번호입니다.
TERM1_LOCATION_ID: 첫 번째 용어가 포함된 용어집의 위치 ID입니다.
TERM1_GLOSSARY_ID: 첫 번째 용어가 포함된 용어집의 ID입니다.
TERM1_ID: 첫 번째 용어의 ID입니다.
TERM2_PROJECT_NUMBER: 관련 용어로 연결할 두 번째 용어의 프로젝트 번호입니다. 두 용어가 동일한 프로젝트에 있는 경우 이 값은 첫 번째 용어의 프로젝트 번호와 동일합니다.
TERM2_LOCATION_ID: 두 번째 용어가 포함된 용어집의 위치 ID입니다. 두 용어가 동일한 위치에 있는 경우 이 값은 첫 번째 용어의 위치 ID와 동일합니다.
TERM2_GLOSSARY_ID: 두 번째 용어가 포함된 용어집의 ID입니다. 두 용어가 동일한 용어집에 있는 경우 이 값은 첫 번째 용어의 용어집 ID와 동일합니다.
TERM2_ID: 두 번째 용어의 ID입니다.
ENTRY_LINK_ID: 두 용어 간 링크의 ID입니다. 각 용어는 Dataplex 범용 카탈로그 항목으로 표시됩니다. 항목 링크는 관련 용어 간의 관계입니다.

동의어와 관련 용어 간의 링크 삭제

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집을 펼치고 동의어 또는 관련 용어를 삭제할 용어를 클릭합니다.
관련 용어 간의 링크를 삭제하려면 관련 용어 옆에 있는 수정을 클릭합니다. 관련 용어를 삭제한 다음 닫기를 클릭합니다.
동의어 간의 링크를 삭제하려면 동의어 옆에 있는 수정을 클릭합니다. 동의어를 삭제한 다음 닫기를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

용어와 데이터 애셋 간의 연결 관리

데이터 애셋 또는 데이터 애셋 열에 용어를 연결할 수 있습니다. 예를 들어 BigQuery 데이터 세트에 약관을 첨부할 수 있습니다.

데이터 애셋에 용어 연결

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 검색 페이지로 이동합니다.

검색 페이지로 이동
용어를 연결할 데이터 애셋 (예: 데이터 세트, 파일 또는 테이블)을 검색한 다음 클릭합니다.
데이터 애셋 페이지에서 다음 중 하나를 수행합니다.
- 약관을 애셋에 연결하려면 세부정보 탭의 용어집 섹션에서 추가를 클릭합니다. 용어를 검색하여 선택한 다음 닫기를 클릭합니다.
- 저작물에 스키마가 있는 경우 용어를 열에 연결할 수 있습니다. 스키마 탭에서 용어를 연결할 열을 선택한 다음 비즈니스 용어 추가를 클릭합니다. 용어를 검색하여 선택한 다음 닫기를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

다음을 바꿉니다.

PROJECT_NUMBER: 연결되는 데이터 애셋의 프로젝트 번호
ENTRY_LOCATION_ID: 연결할 데이터 애셋의 위치 ID
ENTRY_GROUP_ID: 연결할 데이터 애셋의 항목 그룹
ENTRY_LINK_ID: 용어와 데이터 애셋을 나타내는 Dataplex 범용 카탈로그 항목 간 링크의 ID입니다.
TERM_PROJECT_NUMBER: 연결되는 용어의 프로젝트 번호입니다.

항목 스키마의 열에 용어 연결

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 검색 페이지로 이동합니다.

검색 페이지로 이동
용어를 연결할 열이 있는 스키마가 있는 데이터 애셋 (예: 데이터 세트, 파일, 테이블)을 검색합니다. 데이터 애셋을 클릭합니다.
데이터 애셋 페이지에서 다음 중 하나를 수행합니다.
- 데이터 애셋의 열에 용어를 연결하려면 스키마 탭에서 용어를 연결할 열을 선택합니다.
- 비즈니스 용어 추가를 클릭합니다. 연결할 용어를 검색하고 연결할 용어를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE"
  "path": "Schema/COLUMN_NAME"
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

다음을 바꿉니다.

PROJECT_NUMBER: 연결할 데이터 애셋의 프로젝트 번호
ENTRY_LOCATION_ID: 연결할 데이터 애셋의 위치 ID
ENTRY_GROUP_ID: 연결할 데이터 애셋의 항목 그룹
ENTRY_LINK_ID: 용어와 데이터 애셋을 나타내는 Dataplex 범용 카탈로그 항목 간 링크의 ID
TERM_PROJECT_NUMBER: 연결되는 용어의 프로젝트 번호
COLUMN_NAME: 용어를 연결할 열

데이터 애셋에서 용어 삭제

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 검색 페이지로 이동합니다.

검색 페이지로 이동
약관을 삭제할 데이터 애셋 (예: 데이터 세트, 파일, 테이블)을 검색하여 클릭합니다.
데이터 애셋 페이지에서 다음 중 하나를 수행합니다.
- 애셋에서 용어를 삭제하려면 세부정보 탭의 용어집 용어 섹션에서 용어를 클릭합니다. 그런 다음 를 클릭합니다.
- 열에서 용어를 삭제하려면 스키마 탭에서 용어 옆에 있는 를 클릭합니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

용어집, 용어, 연결된 데이터 애셋 찾기

콘솔

비즈니스 용어집 콘텐츠를 탐색하려면 용어집 페이지에서 용어집 및 용어 트리를 사용합니다.

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집 페이지에서 필터 표시줄을 사용하여 카테고리를 찾습니다. 사용 가능한 필터는 다음과 같습니다.
- 이름: 제공한 텍스트가 이름에 포함된 용어집, 카테고리, 용어를 반환합니다.
- 상위: 상위 용어집 이름 또는 설명이 제공된 텍스트와 일치하는 용어를 반환합니다. 예를 들어 parent:Finance는 이름 또는 설명에 Finance 구문이 포함된 상위 용어집과 연결된 용어를 반환합니다.
- 동의어: 이름 또는 ID에 제공된 텍스트가 포함된 동의어가 있는 용어 목록을 반환합니다. 예를 들어 synonym:Profit는 이름 또는 ID에 profit 구문이 포함된 동의어 용어가 있는 용어를 반환합니다.
- 연락처: 데이터 관리자가 연락처로 나열된 용어를 반환합니다. 예를 들어 contact:alex@example.com는 데이터 관리자가 alex@example.com와 일치하는 용어에 연결된 항목을 반환합니다.

REST

REST API를 사용하여 용어집, 용어, 연결된 데이터 애셋을 찾으려면 미리보기에 가입해야 합니다.

용어에 연결된 데이터 애셋 검색

콘솔

Google Cloud 콘솔에서 Dataplex 범용 카탈로그 용어집 페이지로 이동합니다.

용어집으로 이동
용어집 페이지에서 필터 막대를 사용하여 자유 형식 텍스트 검색어를 입력합니다. 그러면 용어집, 카테고리, 용어 이름에서 상응하는 일치 항목 목록이 반환됩니다.
일치하는 용어를 클릭합니다.
용어 세부정보 페이지에서 이 용어에 연결된 용어 (동의어 및 관련 용어)와 연결된 항목 (데이터 애셋)을 확인합니다.
Dataplex 범용 카탈로그에서 항목의 세부정보를 보려면 항목을 클릭합니다.

REST

REST API를 사용하여 용어집, 용어, 연결된 데이터 애셋을 찾으려면 미리보기에 가입해야 합니다.

용어집과 용어 간 또는 용어와 데이터 애셋 간 링크 가져오기

다른 카탈로그 작성 도구에서 용어집과 링크를 가져오거나 Dataplex 범용 카탈로그에서 용어집을 업데이트하려면 REST API를 사용하여 용어집, 카테고리, 용어, 용어 간 링크, 용어와 데이터 애셋 간 링크 또는 열을 일괄 가져오면 됩니다.

대상 용어집을 만듭니다.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF

{
 "displayName": "DISPLAY_NAME",
 "description": "DESCRIPTION"
}
EOF
)"

다음을 바꿉니다.

PROJECT_ID: 용어집을 만들 프로젝트 ID
LOCATION_ID: 용어집을 만들려는 위치
GLOSSARY_ID: 용어집 ID
DISPLAY_NAME: 용어집의 표시 이름
DESCRIPTION: 용어집 설명

생성된 타겟 용어집에서 카테고리, 용어, 용어와 데이터 애셋 간의 링크를 가져오려면 각 항목의 파일을 Cloud Storage 버킷에 업로드합니다. 이러한 파일은 다음 형식입니다.

용어집의 용어 및 카테고리 샘플 형식

 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}

용어 간 링크의 샘플 형식

 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}

용어와 데이터 애셋 간 링크의 샘플 형식

 projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}

# Set GCURL alias
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "glossaries": "GLOSSARY_NAME"
     }
  }
}
EOF
)"

DATAPLEX_API를 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID 형식의 Dataplex 범용 카탈로그 API 엔드포인트로 바꿉니다.

선택사항: 작업 상태를 가져옵니다.

gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

OPERATION_ID를 작업의 ID로 바꿉니다.

선택사항: 메타데이터 작업의 상태를 가져옵니다.

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID

용어 간 링크를 동의어 또는 관련 용어로 가져옵니다.

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
           "projects/dataplex-types/locations/global/entryLinkTypes/related"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
  }
}
EOF
)"

DATAPLEX_API를 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID로 바꿉니다.

용어와 데이터 애셋 또는 열 간의 링크를 가져옵니다.

용어집 용어와 데이터 애셋 간의 링크를 만들려면 데이터 애셋의 항목이 속한 각 항목 그룹에 대해 가져오기 작업을 실행합니다. 모든 정의 항목 링크는 이 항목 그룹에 생성됩니다.

참고: Cloud Storage 버킷의 가져오기 파일에 하나의 항목 그룹에 있는 링크의 파일이 포함되어 있는지 확인하세요. 다른 항목 그룹의 데이터 애셋에 대한 용어와 항목 간 링크를 만들려면 Cloud Storage 버킷에 새 파일을 제공하세요.
```
gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
"type":"IMPORT",
"import_spec":{
  "log_level":"DEBUG",
  "source_storage_uri":"gs://STORAGE_BUCKET/",
  "entry_sync_mode":"FULL",
  "aspect_sync_mode":"INCREMENTAL",
  "scope":{
     "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
     ],
     "entry_link_types":[
        "projects/dataplex-types/locations/global/entryLinkTypes/definition"
     ],
     "referenced_entry_scopes":[
        "PROJECT_IDS"
     ]
  }
}
}
EOF
)"
```
DATAPLEX_API를 dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID로 바꿉니다.

가격 책정

2026년 7월부터 Dataplex 범용 카탈로그 비즈니스 용어집에 메타데이터 스토리지 가격 책정과 동일한 요금이 청구됩니다. Dataplex 범용 카탈로그 메타데이터 스토리지 가격 책정을 참고하세요.

다음 단계

Data Catalog의 비즈니스 용어집 프리뷰 버전을 사용하는 경우 Dataplex 범용 카탈로그의 비즈니스 용어집으로 전환을 참고하세요.

비즈니스 용어집 관리하기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

비즈니스 용어집의 요소

용어집

카테고리

용어

동의어 용어

관련 용어

제한사항

필요한 역할

필수 권한

비즈니스 용어집 만들기 및 관리

비즈니스 용어집 만들기

콘솔

REST

사용 가능한 용어집 보기

콘솔

REST

용어집 수정

콘솔

REST

용어집 삭제

콘솔

REST

카테고리 만들기 및 관리

용어집 아래에 카테고리 만들기

콘솔

REST

중첩된 카테고리 만들기

콘솔

REST

용어집에 속한 카테고리 보기

콘솔

REST

카테고리 수정

콘솔

REST

카테고리 삭제

콘솔

REST

용어 만들기 및 관리

비즈니스 용어집 아래에 용어 만들기

콘솔

REST

카테고리 아래에 용어 만들기

콘솔

REST

용어집 또는 카테고리에서 용어 보기

콘솔

REST

용어 세부정보 보기

콘솔

REST

용어 수정하기

콘솔

REST

용어 삭제

콘솔

REST

동의어 및 관련 용어 관리

용어 간에 동의어 링크 만들기

콘솔

REST

용어 간 관련 링크 만들기

콘솔

REST

동의어와 관련 용어 간의 링크 삭제

콘솔

REST

용어와 데이터 애셋 간의 연결 관리

데이터 애셋에 용어 연결

콘솔

REST

항목 스키마의 열에 용어 연결

콘솔

REST

데이터 애셋에서 용어 삭제

콘솔

REST

용어집, 용어, 연결된 데이터 애셋 찾기

콘솔

비즈니스 용어집 관리하기