2026년 4월 10일부터 Dataplex Universal Catalog가 Knowledge Catalog로 변경되었습니다. API, 클라이언트 라이브러리, CLI, IAM 이름은 변경되지 않습니다. 자세한 내용은 Google Cloud Knowledge Catalog 소개를 참조하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

거버넌스 워크플로를 사용하여 메타데이터 변경 요청

이 문서에서는 거버넌스 워크플로를 사용하여 비즈니스 용어집 카테고리 및 용어와 Knowledge Catalog(이전의 Dataplex Universal Catalog) 항목에 대한 단일 리소스 변경사항을 제안하는 방법을 설명합니다.

시작하기 전에

메타데이터 변경에 거버넌스 워크플로를 사용하려면 필요한 API를 사용 설정하고 필요한 Identity and Access Management(IAM) 역할 및 권한이 있는지 확인합니다.

Dataplex API가 아직 사용 설정되지 않았으면 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기

API 사용 설정하기

필요한 역할

메타데이터 변경을 요청하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트, 용어집 또는 항목 그룹에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

메타데이터 변경 요청: Dataplex 카탈로그 뷰어(roles/dataplex.catalogViewer)
메타데이터 변경사항 승인:
- Dataplex 워크플로 승인자(roles/dataplex.workflowApprover)
- Dataplex 카탈로그 편집자(roles/dataplex.catalogEditor)
- Dataplex 항목 소유자(roles/dataplex.entryOwner)
거버넌스 워크플로 관리: Dataplex 워크플로 관리자(roles/dataplex.workflowAdmin)

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

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

역할 및 권한에 대한 자세한 내용은 Knowledge Catalog IAM 역할을 참조하세요.

용어집 카테고리 변경 요청

용어집 카테고리를 만들거나 업데이트하거나 삭제할 수 있는 직접 쓰기 액세스 권한이 없는 경우 거버넌스 워크플로를 사용하여 이러한 변경을 요청할 수 있습니다. 메타데이터 변경 요청이 제출되면 요청자, 승인자, 워크플로 관리자는 수명 주기 전반에서 요청을 모니터링하고 관리할 수 있습니다.

카테고리 만들기

콘솔

카테고리를 요청하려면 다음 단계를 따르세요.

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

용어집으로 이동
카테고리를 만들려는 용어집을 선택한 후 카테고리 만들기를 클릭합니다.
카테고리의 표시 이름을 입력합니다.
선택사항: 라벨 섹션에서 용어집의 라벨을 추가합니다.
선택사항: 근거 섹션에서 승인 담당자에게 변경 이유를 제공합니다.
자동 생성된 ID를 변경하려면 고급 설정 섹션에서 카테고리 ID를 수정하면 됩니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

카테고리 생성을 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

카테고리 업데이트

콘솔

카테고리 변경을 제안하려면 다음 단계를 따르세요.

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

용어집으로 이동
업데이트하려는 카테고리가 포함된 용어집을 선택합니다.
카테고리 이름을 클릭하여 카테고리 세부정보 창을 엽니다.
카테고리 세부정보를 추가하거나 업데이트하려면 업데이트할 섹션 옆에 있는 추가 또는 수정을 클릭합니다.
제출하여 검토받기를 클릭합니다. 일부 항목의 경우 변경에 대한 추가 근거가 필요할 수 있습니다. 사유를 입력하고 변경사항 제출 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

카테고리 표시 이름 및 설명 업데이트를 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
CATEGORY_ID: 업데이트하려는 타겟 카테고리의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

카테고리 삭제

콘솔

카테고리 삭제를 요청하려면 다음 단계를 따르세요.

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

용어집으로 이동
용어집을 펼치고 삭제하려는 카테고리를 클릭합니다.
카테고리 세부정보 창의 메뉴에서 삭제를 선택합니다.
선택사항: 근거 섹션에서 승인 담당자에게 변경 이유를 제공합니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

카테고리 삭제를 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
CATEGORY_ID: 삭제하려는 대상 카테고리의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

용어집 용어 변경 요청

용어집 용어를 만들거나 업데이트하거나 삭제할 수 있는 직접 쓰기 액세스 권한이 없는 경우 거버넌스 워크플로를 사용하여 이러한 변경을 요청할 수 있습니다.

용어집 용어 만들기

콘솔

용어집 용어 생성을 요청하려면 다음 단계를 따르세요.

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

용어집으로 이동
용어를 만들려는 용어집 또는 카테고리를 선택하여 세부정보 창을 엽니다.
- 용어집 세부정보 페이지에서 용어를 만드는 경우 메뉴에서 용어 만들기를 선택합니다.
- 카테고리 세부정보 페이지에서 용어를 만드는 경우 메뉴에서 용어 추가를 선택합니다.
카테고리의 표시 이름을 입력합니다.
선택사항: 라벨 섹션에서 용어의 라벨을 추가합니다.
선택사항: 근거 섹션에서 승인 담당자에게 변경 이유를 제공합니다.
고급 설정 섹션에서 자동 생성된 ID를 변경하려면 용어 ID를 수정하면 됩니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

용어집 용어 만들기를 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

용어집 용어 업데이트

콘솔

용어집 용어 변경을 요청하려면 다음 단계를 따르세요.

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

용어집으로 이동
업데이트할 용어가 포함된 용어집을 선택합니다.
용어 이름을 클릭하여 용어 세부정보 창을 엽니다.
업데이트하려는 섹션 옆에 있는 추가 또는 수정을 클릭하여 용어 세부정보를 추가하거나 업데이트합니다.
제출하여 검토받기를 클릭합니다. 일부 섹션에서는 요청을 제출하기 전에 추가 근거를 제공해야 할 수 있습니다. 사유를 입력하고 변경사항 제출로 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

용어집 용어 표시 이름 및 설명 업데이트를 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
TERM_ID: 업데이트할 대상 용어의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

용어집 용어 삭제

콘솔

용어 삭제를 요청하려면 다음 단계를 따르세요.

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

용어집으로 이동
삭제할 용어가 포함된 용어집을 선택합니다.
용어 이름을 클릭하여 용어 세부정보 창을 엽니다.
삭제를 클릭합니다.
제출하여 검토받기를 클릭합니다. 일부 섹션에서는 요청을 제출하기 전에 추가 근거를 제공해야 할 수 있습니다. 사유를 입력하고 변경사항 제출로 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

용어집 용어 삭제를 요청하려면 glossaries.requestGlossaryChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 용어집이 있는 리전입니다(예: us-central1).
GLOSSARY_ID: 상위 용어집의 ID입니다.
TERM_ID: 삭제하려는 타겟 용어의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 ChangeRequest의 리소스 이름이 포함된 RequestGlossaryChangeResponse를 반환합니다. 시스템은 새 변경 요청을 로깅하고 승인자에게 알립니다.

항목 변경 요청

Knowledge Catalog 항목을 만들거나 수정하거나 삭제할 수 있는 직접 쓰기 액세스 권한이 없는 경우 거버넌스 워크플로를 사용하여 이러한 변경을 요청할 수 있습니다.

항목 만들기

콘솔

항목 생성을 요청하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.

메타데이터 유형으로 이동
항목 그룹 탭을 클릭합니다.
항목을 만들 항목 그룹을 선택한 후 항목 만들기를 클릭합니다.
항목의 ID와 표시 이름을 입력합니다.
항목 유형을 선택합니다.
선택사항: 관점 세부정보를 제공하거나 설명을 추가합니다.
제출하여 검토받기를 클릭합니다. 일부 섹션에서는 요청을 제출하기 전에 추가 근거를 제공해야 할 수 있습니다. 사유를 입력하고 변경사항 제출로 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

항목 만들기를 요청하려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_TYPE_ID: 항목 유형의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

항목 업데이트

콘솔

항목 업데이트를 요청하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Knowledge Catalog 검색 또는 카탈로그 페이지로 이동합니다.

검색 페이지로 이동

업데이트하려는 항목을 검색하고 선택합니다.
항목을 클릭하여 항목 세부정보 페이지를 엽니다.
업데이트할 섹션 옆에 있는 추가를 클릭합니다.
섹션을 업데이트합니다.
제출하여 검토받기를 클릭합니다. 일부 섹션에서는 요청을 제출하기 전에 추가 근거를 제공해야 할 수 있습니다. 사유를 입력하고 변경사항 제출로 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

항목 소스 표시 이름 및 설명 업데이트를 요청하려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_ID: 대상 항목의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

항목 삭제

콘솔

항목 삭제를 요청하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Knowledge Catalog 검색 또는 카탈로그 페이지로 이동합니다.

검색 페이지로 이동

삭제하려는 항목을 검색하고 선택합니다.
항목을 클릭하여 항목 세부정보 페이지를 엽니다.
삭제를 클릭합니다.
제출하여 검토받기를 클릭합니다. 일부 섹션에서는 요청을 제출하기 전에 추가 근거를 제공해야 할 수 있습니다. 사유를 입력하고 변경사항 제출로 진행을 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

항목 삭제를 요청하려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_ID: 삭제하려는 대상 항목의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

관점 업데이트

콘솔

관점 업데이트를 요청하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.

검색 페이지로 이동

변경을 요청하려는 항목을 검색하고 선택합니다.
항목을 클릭하여 항목 세부정보 페이지를 엽니다.
관점 섹션으로 이동하여 추가를 클릭합니다.
관점 세부정보를 제공합니다.
선택사항: 변경 사유를 입력합니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

항목에 연락처 관점을 연결하거나 업데이트하도록 요청하려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_ID: 대상 항목의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

항목 링크 만들기

콘솔

항목 링크를 만들려면 다음 단계를 따르세요(예: 용어집 용어 연결).

Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.

검색 페이지로 이동
용어를 연결할 데이터 애셋 항목을 검색하고 선택합니다.
항목 세부정보 페이지에서 다음 중 하나를 수행합니다.
- 용어를 항목에 연결하려면 세부정보 탭의 용어집 용어 섹션에서 추가를 클릭합니다.
- 용어를 열에 연결하려면 스키마 탭에서 열을 선택하고 비즈니스 용어 추가를 클릭합니다.
연결할 용어를 검색하여 선택합니다.
선택사항: 변경 사유를 입력합니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

용어집 용어와 데이터 애셋 항목 간의 정의 링크를 만들려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_ID: 대상 항목의 ID입니다.
GLOSSARY_ID: 용어가 포함된 용어집의 ID입니다.
TERM_ID: 용어집 용어의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

항목 링크 삭제

콘솔

다음 단계에 따라 항목 링크 삭제를 요청합니다(예: 연결된 용어집 용어 삭제).

Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.

검색 페이지로 이동
연결된 용어를 삭제할 데이터 애셋 항목을 검색하여 선택합니다.
항목 세부정보 페이지에서 다음 중 하나를 수행합니다.
- 항목에서 용어를 삭제하려면 세부정보 탭의 용어집 용어 섹션에서 용어를 클릭한 후 삭제를 클릭합니다.
- 열에서 용어를 삭제하려면 스키마 탭에서 용어 옆에 있는 삭제를 클릭합니다.
선택사항: 변경 사유를 입력합니다.
제출하여 검토받기를 클릭합니다.

시스템에서 새 변경 요청을 기록하고 승인자에게 알립니다. 내 요청 탭의 거버넌스 워크플로 페이지에서 요청 진행 상황을 추적할 수 있습니다.

REST

용어집 용어와 데이터 애셋 항목 간의 항목 링크 삭제를 요청하려면 entryGroups.requestCatalogChange 메서드를 사용합니다.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

다음을 바꿉니다.

PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
LOCATION: 항목 그룹이 있는 리전입니다(예: us-central1).
ENTRY_GROUP_ID: 상위 항목 그룹의 ID입니다.
ENTRY_LINK_ID: 삭제하려는 대상 항목 링크의 ID입니다.
JUSTIFICATION: 변경사항을 제안하는 이유에 대한 설명입니다.

서비스는 변경 요청의 리소스 이름이 포함된 응답을 반환합니다. 시스템은 새 변경 요청을 기록하고 승인자에게 알립니다.

다음 단계

거버넌스 워크플로에 대해 자세히 알아보기
요청 관리 방법 알아보기
용어집 자세히 알아보기

거버넌스 워크플로를 사용하여 메타데이터 변경 요청 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

필요한 역할

용어집 카테고리 변경 요청

카테고리 만들기

콘솔

REST

카테고리 업데이트

콘솔

REST

카테고리 삭제

콘솔

REST

용어집 용어 변경 요청

용어집 용어 만들기

콘솔

REST

용어집 용어 업데이트

콘솔

REST

용어집 용어 삭제

콘솔

REST

항목 변경 요청

항목 만들기

콘솔

REST

항목 업데이트

콘솔

REST

항목 삭제

콘솔

REST

관점 업데이트

콘솔

REST

항목 링크 만들기

콘솔

REST

항목 링크 삭제

콘솔

REST

다음 단계

거버넌스 워크플로를 사용하여 메타데이터 변경 요청