비즈니스 용어집 관리

이 문서에서는 Dataplex Universal Catalog에서 Dataplex Universal Catalog 비즈니스 용어집을 만들고 관리하는 방법을 설명합니다. 비즈니스 용어집을 사용하여 데이터 애셋의 표준화된 어휘를 설정하면 조직 전반에서 모호성이 줄어들고 데이터 검색과 거버넌스가 향상됩니다.

Dataplex Universal Catalog 비즈니스 용어집 사용 사례

Dataplex Universal Catalog 비즈니스 용어집을 사용하여 데이터 공통 언어를 만들면 다음을 수행할 수 있습니다.

  • 비즈니스 카테고리와 용어의 명확한 계층 구조 정의
  • 동의어를 사용하여 개념을 연결하고 용어 간의 관계 표시
  • 기술 이름뿐만 아니라 비즈니스 개념을 기반으로 데이터 리소스 검색

Dataplex Universal Catalog 비즈니스 용어집을 사용하면 데이터 탐색이 간소화되고 모호성이 줄어들어 더 우수한 거버넌스, 더욱 정확한 분석, 더 빠른 인사이트를 얻을 수 있습니다.

비즈니스 용어집의 요소

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

용어집

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

  • 개요. 비즈니스 용어집의 목적과 콘텐츠를 설명합니다. 이미지, 링크, 표를 추가할 수 있습니다. HTML 서식은 지원되지 않지만 코드 형식으로 HTML 코드를 포함하거나 HTML 페이지에 대한 링크를 추가할 수 있습니다. 굵게, 기울임꼴, 밑줄, 글머리기호 목록, 단락, 제목, 코드 블록과 같은 리치 텍스트 포맷 옵션을 사용할 수도 있습니다. 지원되는 최대 크기는 120KB입니다.

  • 설명. 용어집을 설명합니다. 검색에 도움이 되도록 이 필드의 텍스트에 대한 색인이 생성됩니다. 지원되는 최대 크기는 1KB입니다.

  • 리전. 용어집이 있는 리전을 지정합니다.

카테고리

카테고리를 사용하면 다양한 카테고리와 용어를 구성하고 구조화할 수 있습니다. 카테고리는 비즈니스 용어집 내에서 정의됩니다. 카테고리는 최대 3개 수준까지 중첩할 수 있습니다.

카테고리에는 용어집의 속성과 다음 속성이 포함됩니다.

  • 연락처. 카테고리 유지보수 담당자를 지정합니다. 이 속성은 설명적인 속성이며 카테고리 권한에 영향을 미치지 않습니다.
  • 상위 요소. 현재 카테고리 상위 요소를 설정하는 데 사용되는 관계를 지정합니다. 카테고리를 최대 3개까지 중첩할 수 있습니다.

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

용어

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

용어에는 카테고리 속성과 다음 속성이 포함됩니다.

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

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

동의어 용어

동의어는 서로 다른 두 용어 간의 같음을 나타내는 관계입니다. 서로 다른 팀에서 의미가 같은 두 용어를 다른 용어집에 정의할 때 동의어를 사용합니다. 예를 들어 '이익'과 '순익'이라는 용어를 연결하는 동의어를 만들 수 있습니다.

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

제한사항

필요한 역할

용어집을 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 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
  • 프로젝트에서 동의어 용어 간 링크 생성 및 삭제:
    • 용어집 용어가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryLinks.create 권한. 링크는 권한이 부여된 항목 그룹에서 생성됩니다.
    • 용어집 용어가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryGroups.useSynonymEntryLink 권한. 링크는 권한이 부여된 항목 그룹에서 생성됩니다.
    • 용어를 연결해야 하는 용어집에 대한 dataplex.glossaryTerms.use 권한
    • 링크가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryLinks.delete 권한
  • 프로젝트에서 관련 용어 간 링크 생성 및 삭제:
    • 용어집 용어가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryLinks.create 권한. 링크는 권한이 부여된 항목 그룹에서 생성됩니다.
    • 용어집 용어가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryGroups.useRelatedEntryLink 권한. 링크는 권한이 부여된 항목 그룹에서 생성됩니다.
    • 용어집 용어에 해당하는 항목이 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entries.link 권한
    • 링크가 있는 프로젝트의 Dataplex Universal Catalog 항목 그룹에 대한 dataplex.entryLinks.delete 권한
  • 프로젝트의 용어와 데이터 애셋 또는 열 간의 링크 생성:
    • 프로젝트의 데이터 애셋이나 열에 해당하는 시스템 항목 그룹에 대한 dataplex.entryLinks.create 권한. 링크는 권한이 부여된 프로젝트에서 생성됩니다.
    • 프로젝트의 데이터 애셋이나 열에 해당하는 시스템 항목 그룹에 대한 dataplex.entryGroups.useDefinitionEntryLink 권한. 링크는 권한이 부여된 프로젝트에서 생성됩니다.
    • 프로젝트의 데이터 애셋이나 열에 해당하는 시스템 항목 그룹에 대한 dataplex.entries.link 권한. 링크는 권한이 부여된 프로젝트에서 생성됩니다.
    • 용어를 연결해야 하는 용어집에 대한 dataplex.glossaryTerms.use 권한
    • 링크가 있는 시스템 항목 그룹에 대한 dataplex.entryLinks.delete 권한

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

자세한 내용은 Dataplex Universal Catalog IAM 역할을 참고하세요.

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

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

비즈니스 용어집 만들기

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 비즈니스 용어집 만들기를 클릭합니다.

  3. 비즈니스 용어집 만들기 페이지에서 비즈니스 용어집의 이름과 위치를 지정합니다. 용어집을 만든 후에는 위치를 변경할 수 없습니다.

  4. 만들기를 클릭합니다. 용어집이 현재 프로젝트에 생성됩니다.

  5. 선택사항: 설명에 간단한 설명(최대 1,024자(영문 기준))을 추가하거나 개요에 긴 설명(최대 120KB)을 추가합니다.

REST

용어집을 만들면 Dataplex Universal Catalog에서 용어집을 나타내는 항목을 만듭니다.

  1. 용어집을 만듭니다.

    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자(영문 기준))
  2. 선택사항: 용어집에 개요를 추가합니다.

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

      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를 용어집이 생성된 프로젝트 번호로 바꿉니다.

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

      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 Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

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

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

용어집 수정

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

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 수정하려는 용어집을 클릭합니다.

  3. 이름, 설명 또는 개요 옆에 있는 수정을 클릭한 후 변경합니다.

  4. 저장을 클릭합니다.

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

용어집 삭제

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

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 삭제할 용어집을 클릭합니다.

  3. 삭제를 클릭한 후 메시지가 표시되면 확인합니다.

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개까지 있을 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 카테고리를 만들려는 용어집을 선택한 후 카테고리 만들기를 클릭합니다.

  3. 카테고리 이름을 입력합니다.

  4. 만들기를 클릭합니다.

  5. 선택사항: 설명에 간단한 설명(최대 1,024자(영문 기준))을 추가하거나 개요에 긴 설명(최대 120KB)을 추가합니다.

REST

카테고리를 만들면 Dataplex Universal Catalog에서 카테고리를 나타내는 항목을 만듭니다.

  1. 카테고리를 만듭니다.

    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: 카테고리 설명
  2. 선택사항: 카테고리에 개요를 추가합니다.

    1. 카테고리 항목을 조회합니다.

      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
    2. 카테고리에 개요를 추가합니다.

      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로 바꿔 용어집 카테고리나 용어를 설명합니다.

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

    1. 카테고리 항목을 조회합니다.

      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
    2. 연락처를 사용하여 카테고리 항목을 업데이트합니다.

      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단계까지 중첩될 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 카테고리를 만들려는 용어집을 펼칩니다.

  3. 다른 카테고리를 만들려는 상위 카테고리를 선택하고 카테고리 만들기를 클릭합니다.

  4. 카테고리 이름을 입력합니다.

  5. 만들기를 클릭합니다.

  6. 선택사항: 설명에 간단한 설명(최대 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로 바꿉니다.

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

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 용어집의 카테고리를 보려면 용어집을 펼칩니다.

  3. 카테고리에서 중첩된 카테고리를 보려면 카테고리를 펼칩니다.

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

카테고리 수정

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

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 용어집을 펼치고 수정하려는 카테고리를 클릭합니다.

  3. 이름, 설명 또는 개요 옆에 있는 수정을 클릭한 후 변경합니다.

  4. 저장을 클릭합니다.

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

카테고리 삭제

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 용어집을 펼치고 삭제하려는 카테고리를 클릭합니다.

  3. 삭제를 클릭한 후 메시지가 표시되면 확인합니다.

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개까지 포함될 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Dataplex Universal Catalog 용어집 페이지로 이동합니다.

    용어집으로 이동

  2. 용어집 수준에서 용어를 만들려면 용어를 만들려는 용어집을 선택한 후 용어 만들기를 클릭합니다.

  3. 용어 이름을 입력합니다.

  4. 만들기를 클릭합니다.

  5. 선택사항: 설명에 간단한 설명(최대 1,024자(영문 기준))을 추가하거나 개요에 긴 설명(최대 120KB)을 추가합니다.

  6. 선택사항: 연락처를 추가하려면 수정을 클릭한 후 데이터 관리자, 데이터 소유자 또는 데이터 도메인 소유자의 이메일 주소 목록을 입력합니다. 그런 다음 저장을 클릭하고

REST

용어를 만들면 Dataplex Universal Catalog에서 용어를 나타내는 항목을 만듭니다.

  1. 용어를 만듭니다.

    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: 만들려는 용어에 대한 설명
  2. 선택사항: 용어에 개요를 추가합니다.

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

      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
    2. 용어에 개요를 추가합니다.

      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로 바꿔 용어집 카테고리나 용어를 설명합니다.

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

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

      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
    2. 연락처를 사용하여 용어 항목을 업데이트합니다.

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/