관점 관리 및 메타데이터 보강

이 문서에서는 관점 유형을 만들고 관리하고 관점으로 항목에 주석을 추가하는 방법을 설명합니다.

Dataplex 카탈로그는 일련의 측면으로 항목을 설명합니다. 관점 및 관점 유형을 사용하여 추가 메타데이터로 항목을 설명할 수 있습니다.

자세한 내용은 Dataplex Catalog 개요를 참조하세요.

관점

관점을 통해 항목 내에서 메타데이터를 캡처할 수 있습니다. 항목에 관점을 추가하면 애셋을 사용해야 하는 모든 사용자에게 의미 있는 컨텍스트를 제공할 수 있습니다. 관점을 사용하여 비즈니스 메타데이터(예: 데이터 분류)와 기술 메타데이터(예: 스키마)를 저장할 수 있습니다.

관점은 별도의 리소스가 아닌 항목 리소스의 일부로 간주됩니다. 관점을 수정하면 관점이 포함된 항목을 수정해야 합니다.

항목을 설명할 때는 항목 수준에서, 열을 설명할 때는 열 수준에서 관점을 지정할 수 있습니다.

모든 관점은 관점 유형의 인스턴스입니다. 관점 유형은 관점의 템플릿을 정의합니다. 모든 관점 유형에는 일련의 필드가 포함되어 있습니다. 관점을 만들 때는 이러한 필드의 값을 제공해야 합니다.

특정 항목의 경우 관점 유형별로 항목과 연결된 관점이 최대 1개만 있을 수 있습니다. 관점 유형당 항목 열에 연결된 관점이 여러 개 있을 수 있습니다.

관점 카테고리

관점은 다음과 같이 분류됩니다.

  • 필수 관점: 항목을 만들 때 필수인 관점입니다. 이러한 관점은 특정 항목의 항목 유형에 따라 정의됩니다. 항목 유형에 속하는 모든 항목에는 항상 해당 항목 유형에 의해 정의된 모든 필수 관점이 있어야 합니다.

    Dataplex는 시스템 항목에 필요한 관점(예: 스키마)을 관리합니다.

    다음에 유의하세요.

    • 필수 관점은 항목의 열이 아닌 항목에만 연결할 수 있습니다.

    • 항목에서 필수 관점은 삭제할 수 없습니다.

    • 시스템 항목의 필수 관점을 읽을 수 있지만 수정할 수는 없습니다.

  • 선택적 관점: 선택적 관점을 항목 또는 항목 열과 연결할 수 있습니다. 항목을 만들 때 또는 나중에 항목을 업데이트하여 선택적 관점을 채울 수 있습니다.

    선택적 관점은 채워진 후 삭제할 수 있습니다.

관점 유형

관점 유형은 관점에 템플릿을 제공하는 재사용 가능한 리소스입니다.

관점 유형 카테고리

관점 유형은 다음과 같이 분류됩니다.

  • 커스텀 관점 유형: Dataplex 카탈로그에서 만드는 관점 유형입니다.

  • 시스템 관점 유형: Dataplex에서 제공, 사용, 관리하는 관점 유형입니다.

    시스템 관점 유형은 재사용 가능 및 제한됨으로 세부 분류됩니다. 다음 표에는 시스템 관점 유형의 카테고리와 Dataplex에서 각 카테고리에 제공하는 관점 유형 목록이 나와 있습니다.

    시스템 관점 유형의 카테고리 설명 Dataplex에서 제공하는 관점 유형
    재사용 가능한 시스템 관점 유형 이러한 관점 유형을 사용하여 관점을 만들거나 수정할 수 있습니다.
    • generic
    • storage
    제한된 시스템 관점 유형 Dataplex에서 이러한 관점 유형을 관리합니다.
    이러한 관점 유형의 관점을 읽을 수는 있지만 관점을 만들거나 수정할 수 없습니다.
    • bigquery-connection
    • bigquery-dataset
    • bigquery-model
    • bigquery-routine
    • bigquery-table
    • bigquery-view
    • cloudsql-database
    • cloudsql-instance
    • cloudsql-schema
    • cloudsql-table
    • cloudsql-view
    • storage
    • sql-access
    • storage-bucket
    • storage-folder

    특정 리전 위치 또는 전역 리소스로 커스텀 관점 유형을 만들 수 있습니다. 시스템 관점 유형은 항상 전역입니다. 관점 유형의 위치는 적용 범위에 영향을 미칩니다. 자세한 내용은 프로젝트 및 위치 제약조건을 참조하세요.

시작하기 전에

관점 유형 및 관점을 만들고 관리하기 전에 이 섹션에 설명한 태스크를 완료합니다.

필요한 역할

관점 유형 및 관점을 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 리소스에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

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

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

자세한 내용은 Dataplex IAM 역할을 참조하세요.

API 사용 설정

Dataplex 프로젝트에서 Dataplex API를 사용 설정합니다.

API 사용 설정

관점 유형 만들기

콘솔

  1. Google Cloud 콘솔에서 Dataplex 카탈로그 페이지로 이동합니다.

    카탈로그로 이동

  2. 관점 유형 > 커스텀 탭을 클릭합니다.

  3. 세부정보 섹션에서 다음을 입력합니다.

    1. 선택사항: 표시 이름 필드에 관점 유형의 이름을 입력합니다.
    2. 관점 유형 ID 필드에 관점 유형의 고유 ID를 입력합니다.
    3. 선택사항: 설명 필드에 관점 유형에 대한 설명을 입력합니다.
    4. 위치 필드에서 관점 유형의 위치를 선택합니다. 관점 유형을 만든 후에는 위치를 수정할 수 없습니다.

  4. 선택사항: 관점 유형의 템플릿을 정의합니다.

    템플릿에서 필드 추가를 클릭합니다. 새 필드 섹션에 다음을 입력합니다.

    1. 이름 필드에 이름을 입력합니다.
    2. 선택사항: 표시 이름 필드에 표시 이름을 입력합니다.
    3. 선택사항: 설명 필드에 설명을 입력합니다.

    4. 유형 필드에서 필드의 데이터 유형을 선택합니다. 선택에 따라 다음과 같은 필드 및 옵션 세트가 표시됩니다.

      • 데이터 유형으로 텍스트를 선택한 경우 다음 단계를 따르세요.

        1. 텍스트 유형 필드에서 텍스트 유형을 선택합니다.
        2. 텍스트 값 필드에 텍스트 필드의 힌트를 입력합니다. 이렇게 하려면 값 추가를 클릭하고 힌트를 입력합니다. 텍스트 필드에 여러 개의 힌트를 추가할 수 있습니다.
        3. 완료를 클릭합니다.

      • 데이터 유형으로 Enum을 선택한 경우 enum 값을 추가합니다.

        1. enum 값 추가를 클릭합니다.
        2. 값 필드에 enum 값을 입력합니다. 여러 개의 enum 값을 추가할 수 있습니다.
        3. 완료를 클릭합니다.

      • 데이터 유형으로 배열을 선택한 경우 배열 항목 섹션에서 배열에 표시할 항목의 유형을 정의합니다.

        1. 배열 항목 추가를 클릭합니다.
        2. 이름 필드에 배열 항목의 이름을 입력합니다.
        3. 선택사항: 표시 이름 필드에 배열 항목의 표시 이름을 입력합니다.
        4. 선택사항: 설명 필드에 배열 항목에 대한 설명을 입력합니다.

        5. 유형 필드에서 배열 항목의 데이터 유형을 선택합니다.

          선택에 따라 다음 필드 및 옵션 세트가 표시됩니다. 이들은 이 섹션의 다른 부분에서 설명한 텍스트, enum, 지도, 배열, 레코드 데이터 유형에 대한 옵션과 유사합니다.

        6. 완료를 클릭합니다.

      • 데이터 유형으로 지도를 선택한 경우 지도 값 섹션에서 지도에 표시할 값 유형을 정의합니다.

        1. 지도 값 추가를 클릭합니다.
        2. 이름 필드에 지도의 이름을 입력합니다.
        3. 선택사항: 표시 이름 필드에 지도의 표시 이름을 입력합니다.
        4. 선택사항: 설명 필드에 지도에 대한 설명을 입력합니다.

        5. 유형 필드에서 지도의 데이터 유형을 선택합니다.

          선택에 따라 다음 필드 및 옵션 세트가 표시됩니다. 이들은 이 섹션의 다른 부분에서 설명한 텍스트, enum, 지도, 배열, 레코드 데이터 유형에 대한 옵션과 유사합니다.

        6. 완료를 클릭합니다.

      • 데이터 유형으로 레코드를 선택한 경우 다음을 입력합니다.

        1. 레코드 ID 필드에 다른 레코드 필드에서 이 레코드를 참조하는 데 사용할 수 있는 고유 ID를 입력합니다. 이 문서의 레코드 ID 및 레코드 참조 필드 사용 예시 섹션을 참조하세요.
        2. 선택사항: 이 템플릿에서 다른 레코드에 대한 참조를 추가하려면 레코드 참조 필드를 사용하세요. 관점 유형을 만든 후에는 이를 수정할 수 없습니다. 이 문서의 레코드 ID 및 레코드 참조 필드 사용 예시 섹션을 참조하세요.

        3. 레코드 필드 섹션에서 여러 개의 중첩 필드가 있는 복합 객체를 정의할 수 있습니다. 이렇게 하려면 레코드 필드 항목 추가를 클릭하고 다음을 지정합니다.

          1. 이름 필드에 레코드 필드의 이름을 입력합니다.
          2. 선택사항: 표시 이름 필드에 레코드 필드의 표시 이름을 입력합니다.
          3. 선택사항: 설명 필드에 레코드 필드에 대한 설명을 입력합니다.

          4. 유형 필드에서 데이터 유형을 선택합니다.

            선택에 따라 다음 필드 및 옵션 세트가 표시됩니다. 이 옵션은 이 섹션의 앞부분에서 설명한 텍스트, enum, 지도, 배열, 레코드 데이터 유형에 대한 옵션과 유사합니다.

        4. 완료를 클릭합니다.

    5. 이 유형의 관점에 대해 해당 필드를 필수로 만들려면 필수를 선택합니다. 필수 관점 및 선택적 관점에 관한 자세한 내용은 이 문서의 관점 카테고리 섹션을 참조하세요.

    6. 완료를 클릭합니다.

    7. 필드를 여러 개 추가하려면 필드 추가를 클릭하고 이전 단계를 반복합니다.

  5. 선택사항: 라벨 섹션에서 리소스에 키-값 쌍으로 임의의 라벨을 추가합니다.

    1. 라벨 추가를 클릭합니다.
    2. 키 필드에 키를 입력합니다.
    3. 값 필드에 키 값을 입력합니다.
    4. 라벨을 추가하려면 라벨 추가를 클릭하고 단계를 반복합니다.

  6. 저장을 클릭합니다.

관점 유형을 만든 후 항목에 관점을 추가할 수 있습니다.

REST

새 관점 유형을 만들려면 aspectType.create 메서드를 사용합니다.

레코드 ID 및 레코드 참조 필드 사용 예시

재귀 참조에는 레코드 ID 및 레코드 참조 필드를 사용할 수 있습니다. 다음 예시에서는 이러한 필드를 사용하는 방법을 보여줍니다.

다음 필드가 있는 Employee라는 관점 유형을 생각해 보겠습니다.

  • 이름(유형:Text)
  • 시작일(유형:Date & time)
  • 지정(유형:Text)
  • 현재 주소(유형:Record)
  • 영구 주소(유형:Record)

두 주소 필드인 현재 주소와 영구 주소는 동일한 데이터 유형 Record입니다. 중복을 방지하려면 이러한 필드를 정의할 때 레코드 ID 및 레코드 참조 값을 설정할 수 있습니다.

현재 주소 필드를 정의할 때 레코드 ID를 address-field로 지정할 수 있습니다. 영구 주소의 경우 레코드 참조에 동일한 값(address-field)을 지정할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름(유형:Text)
  • 시작일(유형:Date & time)
  • 지정(유형:Text)
  • 현재 주소(유형:Record, 레코드 ID:address-field)
  • 영구 주소(유형:Record, 레코드 참조:address-field)

이렇게 하면 다른 주소의 필드를 중복으로 입력하지 않아도 됩니다.

항목에 관점 추가

관점 유형을 만든 후에는 해당 유형의 관점을 만들 수 있습니다. 항목에 관점을 추가하려면 항목을 업데이트해야 합니다. 관점은 항목 내에 저장되기 때문입니다.

다음에 유의하세요.

  • 항목 또는 항목의 열에 관점을 추가할 수 있습니다.
  • 커스텀 항목에 대해서만 필수 관점을 수정할 수 있습니다. 필수 관점은 삭제할 수 없습니다.

  • 커스텀 항목과 시스템 항목 모두에 대해 선택적 관점을 수정하고 삭제할 수 있습니다.

콘솔

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

    검색 페이지로 이동

  2. 검색 플랫폼 선택에서 검색 모드로 Dataplex 카탈로그를 선택합니다.

  3. 관점을 추가할 항목을 검색하고 항목을 클릭합니다.

    항목 세부정보 페이지가 열립니다.

  4. 항목에 관점을 추가하려면 다음 단계를 따르세요.

    1. 항목 세부정보 페이지에서 세부정보 탭을 클릭합니다.
    2. 항목에 필수 관점 또는 선택적 관점을 추가하려면 관점 섹션에서 각 카테고리의 추가를 클릭합니다.
      선택한 항목의 항목 유형에 정의된 필수 관점이 없는 경우 필수 관점을 추가할 수 없습니다.
    3. 추가하려는 관점을 검색하고 선택합니다.
    4. 관점 추가 창에서 필드 값을 입력합니다.
    5. 저장을 클릭합니다.

  5. 항목의 열에 관점을 추가하려면 다음 단계를 따르세요.

    1. 항목 세부정보 페이지에서 스키마 탭을 클릭합니다.
    2. 관점을 추가할 열을 선택합니다.
    3. 관점 추가를 클릭합니다.
    4. 추가하려는 관점을 검색하고 선택합니다.
    5. 관점 추가 창에서 필드 값을 입력합니다.
    6. 저장을 클릭합니다.

REST

항목 또는 항목의 열에 관점을 추가하려면 entry.patch 메서드를 사용합니다.

각 관점 유형과 항목이 서로 다른 Google Cloud 조직에 있는 항목에서 관점을 만들고 사용하는 것은 지원되지 않습니다.

항목의 기존 관점 관리

이 섹션에서는 항목의 기존 관점을 업데이트하고 삭제하는 방법을 설명합니다.

관점 업데이트

커스텀 항목과 시스템 항목 모두에 대해 선택적 관점을 수정할 수 있습니다. 커스텀 항목에 대해서만 필수 관점을 수정할 수 있습니다.

콘솔

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

    검색 페이지로 이동

  2. 검색 플랫폼 선택에서 검색 모드로 Dataplex 카탈로그를 선택합니다.

  3. 업데이트할 관점이 있는 항목을 검색하고 항목을 클릭합니다.

    항목 세부정보 페이지가 열립니다.

  4. 세부정보 탭을 클릭합니다.

  5. 업데이트하려는 관점에서 수정을 클릭합니다.

  6. 관점 수정 창에서 필수 입력란을 업데이트합니다.

  7. 저장을 클릭합니다.

REST

항목 또는 항목의 열에 대한 관점을 업데이트하려면 entry.update 메서드를 사용합니다.

관점 삭제

콘솔

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

    검색 페이지로 이동

  2. 검색 플랫폼 선택에서 검색 모드로 Dataplex 카탈로그를 선택합니다.

  3. 삭제하려는 관점이 있는 항목을 검색하고 항목을 클릭합니다.

    항목 세부정보 페이지가 열립니다.

  4. 세부정보 탭을 클릭합니다.

  5. 삭제하려는 관점에서 삭제를 클릭합니다.

  6. 확인을 클릭합니다.

REST

항목의 관점을 삭제하려면 entry.update 메서드를 사용합니다.

관점 유형 관리

이 섹션에서는 관점 유형을 보고, 업데이트하고, 삭제하는 방법을 설명합니다.

사용 가능한 관점 유형 목록 보기

콘솔

  1. Google Cloud 콘솔에서 Dataplex 카탈로그 페이지로 이동합니다.

    카탈로그로 이동

  2. 관점 유형 탭을 클릭합니다.

    커스텀 및 시스템 관점 유형 목록에 액세스할 수 있습니다. 자세한 내용은 이 문서의 관점 유형 카테고리 섹션을 참조하세요.

    커스텀 탭에서 서픽스가 (Data Catalog)인 관점 유형은 Data Catalog에서 마이그레이션된 태그 템플릿입니다.

  3. 모든 프로젝트의 관점 유형 목록을 보려면 커스텀 탭을 클릭한 다음 모든 프로젝트에서 표시 전환 버튼을 클릭하여 사용 설정으로 전환합니다.

REST

사용 가능한 모든 관점 유형을 나열하려면 aspectTypes.list 메서드를 사용합니다.

관점 유형 세부정보 보기

콘솔

  1. Google Cloud 콘솔에서 Dataplex 카탈로그 페이지로 이동합니다.

    카탈로그로 이동

  2. 관점 유형 탭을 클릭합니다.

  3. 관점 유형을 클릭합니다.

    관점 유형 세부정보 페이지가 열립니다. 선택한 관점 유형의 표시 이름, 관점 유형 ID, 설명, 프로젝트 ID, 위치, 라벨, 생성일, 최종 수정일 등의 정보를 확인할 수 있습니다.

  4. 선택한 관점 유형의 구조를 보려면 템플릿 탭을 클릭합니다.

  5. 최근에 생성된 관련 항목 10개의 목록을 보려면 샘플 항목 탭을 클릭합니다.

  6. 관련 항목을 모두 검색하려면 검색에 관련 항목 모두 표시를 클릭합니다. 이 버튼은 관련 항목이 하나 이상 있는 경우에만 표시됩니다.

REST

관점 유형의 세부정보를 가져오려면 aspectTypes.get 메서드를 사용합니다.

관점 유형 업데이트

관점 유형의 표시 이름, 설명, 템플릿 필드, 라벨을 업데이트할 수 있습니다. 템플릿에서 기존 필드는 삭제할 수 없습니다.

관점 유형을 만든 후에는 관점 유형 ID와 위치를 업데이트할 수 없습니다.

콘솔

  1. Google Cloud 콘솔에서 Dataplex 카탈로그 페이지로 이동합니다.

    카탈로그로 이동

  2. 관점 유형 탭을 클릭합니다.

  3. 업데이트할 관점 유형을 클릭합니다.

  4. 관점 유형 세부정보 페이지에서 수정을 클릭합니다.

  5. 필요에 따라 표시 이름, 설명, 템플릿 필드, 라벨을 수정합니다.

  6. 선택사항: 관점 유형의 필드를 지원 중단됨으로 표시하려면 다음 단계를 따르세요.

    1. 템플릿 섹션에서 필드를 펼칩니다.
    2. 지원 중단됨을 선택합니다.
    3. 지원 중단 사유 필드에 선택한 필드의 지원 중단 사유를 입력합니다.
    4. 완료를 클릭합니다.

  7. 저장을 클릭합니다.

REST

기존 관점 유형을 업데이트하려면 aspectTypes.patch 메서드를 사용합니다.

관점 유형 삭제

콘솔

  1. Google Cloud 콘솔에서 Dataplex 카탈로그 페이지로 이동합니다.

    카탈로그로 이동

  2. 관점 유형 탭을 클릭합니다.

  3. 삭제하려는 관점 유형을 클릭합니다.

  4. 관점 유형 세부정보 페이지에서 삭제를 클릭합니다. 메시지가 표시되면 확인합니다.

REST

기존 관점 유형을 삭제하려면 aspectTypes.delete 메서드를 사용합니다.

다음 단계