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

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

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

메타데이터는 데이터 애셋과 데이터 애셋 간의 관계를 구성하고 이해하는 데 매우 중요합니다. 예를 들어 규제 대상 업계는 이름, 주소, 정부 발급 신분증 번호와 같은 개인 식별 정보 (PII)를 보호해야 합니다. 이 데이터는 분산 데이터 시스템 전반에 있는 다양한 인스턴스에서 발생할 수 있습니다. Knowledge Catalog (이전 명칭: Dataplex Universal Catalog)를 사용하면 분산된 데이터 애셋을 빠르게 탐색하고 분류할 수 있습니다. 그런 다음 데이터를 개인 식별 정보로 분류할 수 있습니다.

의미 있는 컨텍스트로 데이터 항목과 항목 링크를 보강하면 데이터를 더 쉽게 탐색하고 유용하게 사용할 수 있습니다. Knowledge Catalog는 관점 유형과 관점을 통해 컨텍스트를 지원합니다.

관점 유형: 관련 데이터를 정의하는 JSON 템플릿입니다. 예를 들어 규정 준수 정보의 경우 개인 식별 정보 분류와 GDPR 규정 준수가 있을 수 있습니다.
관점: 관점 유형 인스턴스입니다. 예를 들면 {"pii_classification": "confidential", "gdpr_compliant": true}입니다. 전체 테이블, 개별 테이블 열 또는 항목 링크에 관점을 적용할 수 있습니다.

데이터를 분류한 후에는 데이터에 데이터 품질 정책이나 액세스 정책을 적용할 수 있습니다.

자세한 내용은 Knowledge Catalog의 메타데이터 정보를 참고하세요.

관점 유형이란 무엇인가요?

관점 유형은 관점 템플릿을 제공하는 재사용 가능한 리소스입니다. 맞춤 관점 유형을 만들 때는 Knowledge Catalog 리소스 이름 지정 가이드라인을 준수하는 ID를 지정해야 합니다.

관점 유형 카테고리

관점 유형은 커스텀 관점 유형과 시스템 관점 유형으로 분류됩니다.

커스텀 관점 유형

Knowledge Catalog에서 만드는 관점 유형을 맞춤 관점 유형이라고 합니다.

참고: Gemini 컨텍스트 검색 경계: BigQuery의 Gemini는 표준 스키마 정의, 테이블 제약 조건, 테이블/열 설명 필드를 기반으로 SQL 생성 및 데이터 추론을 수행합니다. Knowledge Catalog의 사용자 정의 맞춤 관점 유형은 거버넌스, 검색, API 검색을 위해 카탈로그 평면에 저장되지만 Gemini의 컨텍스트 프롬프트 검색 파이프라인에 동적으로 삽입되지는 않습니다. 권장사항: 비즈니스 로직, 의미론적 컨텍스트 또는 개발자 메모가 BigQuery의 Gemini에 표시되도록 하려면 [표](/bigquery/docs/managing-tables#updating_a_tables_description) 및 [열 설명](/bigquery/docs/managing-table-schemas#change-column-description) 필드 내의 [표준 overview 측면](#other-reusable-aspect-types)에 직접 문서화하거나 [비즈니스 용어집 용어](/knowledge-catalog/docs/manage-glossaries)를 사용하세요. 자세한 내용은 [BigQuery와 함께 Knowledge Catalog 사용](/bigquery/docs/use-knowledge-catalog)을 참고하세요.

커스텀 관점 유형은 전역이거나 리전별일 수 있습니다.

전역 관점 유형: 모든 리전의 항목에 관점을 만드는 데 사용할 수 있습니다. 여러 리전의 항목에 같은 구조를 적용해야 하는 경우 global 관점 유형을 선택합니다. 한 번만 정의하면 되기 때문입니다. 전역 관점 유형 정의는 모든 리전에서 복제되므로 관점 유형 스키마 자체에 민감한 정보가 포함되어 있거나 모든 메타데이터 구성요소에 엄격한 데이터 레지던시가 필요한 경우에는 이 옵션이 적합하지 않을 수 있습니다.
리전 관점 유형: 관점 유형과 동일한 리전에 있는 항목의 관점을 만드는 데만 사용할 수 있습니다. 예를 들어 us-central1에서 생성된 관점 유형은 us-central1의 항목에만 사용될 수 있습니다. 관점 유형이 특정 리전의 항목에만 관련되거나 관점 유형 정의가 선택한 리전 내에 있게 하려면 리전 위치를 선택합니다. 이렇게 하면 데이터 주권 요구사항과 규정 준수 요구사항을 충족할 수 있습니다. 리전 관점 유형을 사용하지만 여러 리전에 같은 구조가 필요한 경우 각 리전에서 별도의 관점 유형 정의를 만들어 관리해야 합니다.

특정 리전 위치(예: us-central1)에 또는 global 리소스로 커스텀 관점 유형을 만들 수 있습니다. 관점 유형의 위치는 적용 범위에 영향을 미치며 사용할 수 있는 항목을 결정합니다.

자세한 내용은 프로젝트 및 위치 제약조건을 참조하세요.

시스템 관점 유형

Knowledge Catalog에서 제공, 사용, 관리하는 관점 유형을 시스템 관점 유형이라고 합니다. 시스템 관점 유형은 항상 전역이므로 모든 리전에서 사용될 수 있습니다. 시스템 관점 유형은 프로젝트 번호가 655216118709인 Google 관리 프로젝트에 저장됩니다. 예를 들면 projects/655216118709/locations/global/aspectTypes/schema입니다.

각 시스템 정의 관점 유형, 항목 유형, 항목 링크 유형에는 자체 IAM 권한이 있습니다. 자세한 내용은 시스템 관점 유형, 항목 유형, 항목 링크 유형의 IAM 권한을 참고하세요.

시스템 관점 유형은 재사용 가능 및 제한됨으로 세부 분류됩니다. 다음 표에서는 시스템 관점 유형의 카테고리와 Knowledge Catalog에서 각 카테고리에 제공하는 관점 유형 목록을 설명합니다.

시스템 관점 유형 카테고리	설명	Knowledge Catalog에서 제공하는 관점 유형
재사용 가능한 시스템 관점 유형	이러한 관점 유형을 사용하여 관점을 만들거나 수정할 수 있습니다.	`contacts` `data-profile` `data-quality-scorecard` `generic` `graph-profile` `guidelines` `overview` `schema-join` `schema` `storage` `usage`
제한된 시스템 관점 유형	Knowledge Catalog에서 이러한 관점 유형을 관리합니다. 이러한 관점 유형의 관점을 읽을 수 있지만 만들거나 수정할 수는 없습니다.	다음이 포함되지만 이에 국한되지 않습니다. `analytics-hub` `aspecttype-aspect` `bigquery-dataset` `bigquery-table` `cloudsql-database` `cloudsql-instance` `cloudsql-table` `entrygroup-aspect` `entrytype-aspect` `sensitive-data-protection-profile` `storage-bucket` `storage-folder`

관점이란 무엇인가요?

관점을 사용하면 항목 또는 항목 링크 내에서 메타데이터를 캡처하여 의미 있는 컨텍스트를 제공할 수 있습니다. 관점을 사용하여 다음과 같은 유형의 메타데이터를 저장할 수 있습니다.

비즈니스 메타데이터: 데이터 분류와 같은 비즈니스 컨텍스트를 제공하는 정보입니다.
기술 메타데이터: 항목 또는 항목 링크의 기술 세부정보입니다. 다음이 포함됩니다.
- 항목의 경우 데이터 애셋 자체에 관한 세부정보입니다(예: 스키마).
- 항목 링크의 경우 데이터 애셋 간의 관계에 관한 세부정보입니다(예: 조인 세부정보).
데이터에서 파생된 메타데이터: BigQuery 테이블의 통계와 같이 데이터 자체에서 생성된 정보입니다.

관점은 별도의 독립형 리소스가 아닌 상위 항목 리소스의 구성요소입니다. 관점을 수정하면 포함된 항목이 업데이트됩니다. 이러한 수정사항을 추적하려면 메타데이터 변경 피드를 구독하면 됩니다.

측면 배치 및 타겟 수준

모든 관점은 관점 유형 템플릿의 인스턴스이며, 이 템플릿은 입력해야 하는 필드를 정의합니다. 관점을 적용할 수 있는 위치와 관점이 표시될 수 있는 횟수는 대상 리소스 유형에 따라 다릅니다.

대상 리소스	지원되는 수준	카디널리티 한도
항목	항목 수준 또는 열 수준	항목 수준에서 관점 유형당 최대 하나의 관점 관점 유형당 여러 관점이 서로 다른 열에 허용됩니다.
항목 링크	링크 수준만	링크당 관점 유형당 최대 하나의 관점

관점 카테고리

관점은 필수 관점과 선택적 관점으로 분류됩니다.

필수 관점

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

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

다음에 유의하세요.

필수 관점을 항목의 열이 아닌 항목에만 연결할 수 있습니다.
항목 또는 항목 링크에서 필수 관점을 삭제할 수 없습니다.
시스템 항목의 필수 관점을 읽을 수 있지만 수정할 수는 없습니다.
데이터 관점은 필수 관점일 수 없습니다.

선택적 관점

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

다음에 유의하세요.

선택적 관점이 채워진 후 선택적 관점을 삭제할 수 있습니다.
항목 링크는 필수 관점만 지원합니다.

데이터 관점

일부 측면에는 항목에 관한 메타데이터가 아닌 항목의 기본 데이터에서 파생된 정보가 포함되어 있습니다. 이를 데이터 관점이라고 합니다. 예를 들어 데이터 프로필 스캔 또는 데이터 품질 스캔의 결과에는 데이터 자체에서 파생된 통계가 포함되므로 데이터 측면으로 분류됩니다.

데이터 측면인 시스템 측면 유형은 다음과 같습니다.

data-profile: 데이터 프로필 스캔의 결과를 포함합니다. 자세한 내용은 데이터 프로파일링 정보를 참고하세요.
data-quality-scorecard: 데이터 품질 점수의 요약이 포함됩니다.
data-rules: 항목에 데이터 품질 규칙을 연결합니다.
data-quality-rule-template: 재사용 가능한 데이터 품질 규칙 템플릿을 정의합니다.

시작하기 전에

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

필요한 역할

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

관점 유형 및 데이터 관점을 포함한 Knowledge Catalog의 메타데이터 리소스에 대한 전체 권한: Dataplex 카탈로그 관리자 (roles/dataplex.catalogAdmin)
관점 유형 및 데이터 관점을 포함한 Knowledge Catalog의 메타데이터 리소스를 만들고 관리: Dataplex 카탈로그 편집자 (roles/dataplex.catalogEditor)
커스텀 관점 유형에 대한 전체 권한 (관점 유형을 사용하여 항목을 만들거나 수정할 수 있는 권한 제외): Dataplex 관점 유형 소유자 (roles/dataplex.aspectTypeOwner)
관점 유형 및 관련 IAM 정책 보기: Dataplex 카탈로그 뷰어 (roles/dataplex.catalogViewer)
관점 유형을 사용하여 해당 관점으로 항목을 만들고 수정: Dataplex 관점 유형 사용자 (roles/dataplex.aspectTypeUser)
schema, schema-join, overview, contacts와 같은 일부 시스템 관점 유형의 관점 추가: Dataplex 항목 및 항목 링크 소유자 (roles/dataplex.entryOwner)

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

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

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

API 사용 설정

Knowledge Catalog 프로젝트에서 Dataplex API를 사용 설정합니다. 새 Google Cloud 프로젝트 또는 BigQuery API가 사용 설정된 프로젝트를 사용하는 경우 Dataplex API가 기본적으로 사용 설정됩니다.

API 사용 설정

커스텀 관점 유형 만들기

콘솔

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

메타데이터 유형으로 이동
관점 유형 및 태그 템플릿 > 커스텀 탭을 클릭합니다.
관점 유형 만들기를 클릭합니다.
관점 유형 만들기 창에 다음을 입력합니다.
1. 선택사항: 표시 이름 필드에 관점 유형의 이름을 입력합니다.
2. 관점 유형 ID 필드에 관점 유형의 고유 ID를 입력합니다.
3. 선택사항: 설명 필드에 관점 유형에 대한 설명을 입력합니다.
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. 레코드 필드 섹션에서 중첩 필드가 여러 개 있는 복잡한 객체를 정의할 수 있습니다. 이렇게 하려면 레코드 필드 항목 추가를 클릭하고 다음을 지정합니다.
    4. 이름 필드에 레코드 필드 이름을 입력합니다.
    5. 선택사항: 표시 이름 필드에 레코드 필드 표시 이름을 입력합니다.
    6. 선택사항: 설명 필드에 레코드 필드에 대한 설명을 입력합니다.
    7. 유형 필드에서 데이터 유형을 선택합니다.
      
      선택에 따라 다음 필드 및 옵션 세트가 표시됩니다. 이들은 이 섹션의 앞부분에서 설명한 텍스트, enum, 지도, 배열, 레코드 데이터 유형에 대한 옵션과 유사합니다.
    8. 완료를 클릭합니다.
5. 필드를 이 유형 관점에 대해 필수로 만들려면 필수를 선택합니다. 필수 관점과 선택적 관점에 대한 상세 설명은 이 문서의 관점 카테고리 섹션을 참고하세요.
6. 완료를 클릭합니다.
7. 필드를 여러 개 추가하려면 필드 추가를 클릭하고 이전 단계를 반복합니다.
선택사항: 라벨 섹션에서 리소스에 키-값 쌍으로 임의의 라벨을 추가합니다.
1. 라벨 추가를 클릭합니다.
2. 키 필드에 키를 입력합니다.
3. 값 필드에 키 값을 입력합니다.
4. 라벨을 더 추가하려면 라벨 추가를 클릭하고 단계를 반복합니다.
저장을 클릭합니다.

gcloud

커스텀 관점 유형을 만들려면 gcloud dataplex aspect-types create 명령어를 사용합니다.

C#

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using Google.LongRunning;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for CreateAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CreateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        CreateAspectTypeRequest request = new CreateAspectTypeRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            AspectTypeId = "",
            AspectType = new AspectType(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.CreateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceCreateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateAspectTypeRequest.
	}
	op, err := c.CreateAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.CreateAspectTypeRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncCreateAspectType {

  public static void main(String[] args) throws Exception {
    syncCreateAspectType();
  }

  public static void syncCreateAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      CreateAspectTypeRequest request =
          CreateAspectTypeRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setAspectTypeId("aspectTypeId-423030675")
              .setAspectType(AspectType.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.createAspectTypeAsync(request).get();
    }
  }
}

Node.js

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The resource name of the AspectType, of the form:
 *  projects/{project_number}/locations/{location_id}
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Required. AspectType identifier.
 */
// const aspectTypeId = 'abc123'
/**
 *  Required. AspectType Resource.
 */
// const aspectType = {}
/**
 *  Optional. The service validates the request without performing any
 *  mutations. The default is false.
 */
// const validateOnly = true

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callCreateAspectType() {
  // Construct request
  const request = {
    parent,
    aspectTypeId,
    aspectType,
  };

  // Run request
  const [operation] = await dataplexClient.createAspectType(request);
  const [response] = await operation.promise();
  console.log(response);
}

callCreateAspectType();

Python

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_create_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.CreateAspectTypeRequest(
        parent="parent_value",
        aspect_type_id="aspect_type_id_value",
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.create_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참고하세요.

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the create_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#create_aspect_type.
#
def create_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::CreateAspectTypeRequest.new

  # Call the create_aspect_type method.
  result = client.create_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

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)

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

항목에 관점 추가

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

다음에 유의하세요.

항목이나 항목의 열에 관점을 추가할 수 있습니다.
커스텀 항목에 대한 필수 관점만 수정할 수 있습니다. 필수 관점을 삭제할 수 없습니다.
커스텀 항목과 시스템 항목 모두에 대해 선택적 관점을 수정하고 삭제할 수 있습니다.

콘솔

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

검색 페이지로 이동
검색 플랫폼이 Data Catalog로 설정되어 있는 경우 검색 플랫폼 선택 메뉴에서 Dataplex Universal Catalog를 선택합니다.
관점을 추가할 항목을 검색하고 항목을 클릭합니다. 항목 세부정보 페이지가 열립니다.
항목에 관점을 추가하려면 다음 단계를 수행합니다.
1. 세부정보 탭을 클릭합니다.
2. 필수 관점이나 선택적 관점을 항목에 추가하려면 태그 및 관점 섹션에서 해당 카테고리의 추가를 클릭합니다.
  선택한 항목의 항목 유형에 정의된 필수 관점이 없으면 필수 관점을 추가할 수 없습니다.
3. 추가하려는 관점을 검색하고 선택합니다.
4. 관점 추가 창에서 필드 값을 입력합니다.
5. 저장을 클릭합니다.
6. 항목 열에 관점을 추가하려면 다음 단계를 수행합니다.
7. 항목 세부정보 페이지에서 스키마 탭을 클릭합니다.
8. 관점을 추가할 열을 선택합니다.
9. 관점 추가를 클릭합니다.
10. 추가하려는 관점을 검색하고 선택합니다.
11. 관점 추가 창에서 필드 값을 입력합니다.
12. 저장을 클릭합니다.

gcloud

항목이나 항목 열에 관점을 추가하려면 gcloud dataplex entries update 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

항목 객체에 관점을 추가하려면 관점을 참고하세요.

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

항목 객체에 관점을 추가하려면 항목을 참고하세요.

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.Aspect;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.EntryName;
import com.google.cloud.dataplex.v1.EntrySource;
import com.google.protobuf.FieldMask;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.util.Map;

public class UpdateEntry {

  public static void main(String[] args) throws Exception {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "MY_PROJECT_ID";
    // Available locations: https://cloud.google.com/dataplex/docs/locations
    String location = "MY_LOCATION";
    String entryGroupId = "MY_ENTRY_GROUP_ID";
    String entryId = "MY_ENTRY_ID";

    Entry createdEntry = updateEntry(projectId, location, entryGroupId, entryId);
    System.out.println("Successfully updated entry: " + createdEntry.getName());
  }

  // Method to update Entry located in projectId, location, entryGroupId and with entryId
  public static Entry updateEntry(
      String projectId, String location, String entryGroupId, String entryId) throws Exception {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (CatalogServiceClient client = CatalogServiceClient.create()) {
      Entry entry =
          Entry.newBuilder()
              .setName(EntryName.of(projectId, location, entryGroupId, entryId).toString())
              .setEntrySource(
                  EntrySource.newBuilder()
                      .setDescription("updated description of the entry")
                      .build())
              .putAllAspects(
                  Map.of(
                      "dataplex-types.global.generic",
                      Aspect.newBuilder()
                          .setAspectType(
                              "projects/dataplex-types/locations/global/aspectTypes/generic")
                          .setData(
                              Struct.newBuilder()
                                  // "Generic" Aspect Type have fields called "type" and "system.
                                  // The values below are a sample of possible options.
                                  .putFields(
                                      "type",
                                      Value.newBuilder()
                                          .setStringValue("updated example value")
                                          .build())
                                  .putFields(
                                      "system",
                                      Value.newBuilder()
                                          .setStringValue("updated example system")
                                          .build())
                                  .build())
                          .build()))
              .build();

      // Update mask specifies which fields will be updated.
      // For more information on update masks, see: https://google.aip.dev/161
      FieldMask updateMask =
          FieldMask.newBuilder().addPaths("aspects").addPaths("entry_source.description").build();
      return client.updateEntry(entry, updateMask);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Entry resource.
 */
// const entry = {}
/**
 *  Optional. Mask of fields to update. To update Aspects, the update_mask must
 *  contain the value "aspects".
 *  If the update_mask is empty, the service will update all modifiable fields
 *  present in the request.
 */
// const updateMask = {}
/**
 *  Optional. If set to true and the entry doesn't exist, the service will
 *  create it.
 */
// const allowMissing = true
/**
 *  Optional. If set to true and the aspect_keys specify aspect ranges, the
 *  service deletes any existing aspects from that range that weren't provided
 *  in the request.
 */
// const deleteMissingAspects = true
/**
 *  Optional. The map keys of the Aspects which the service should modify. It
 *  supports the following syntaxes:
 *  * `<aspect_type_reference>` - matches an aspect of the given type and empty
 *  path.
 *  * `<aspect_type_reference>@path` - matches an aspect of the given type and
 *  specified path. For example, to attach an aspect to a field that is
 *  specified by the `schema` aspect, the path should have the format
 *  `Schema.<field_name>`.
 *  * `<aspect_type_reference>@*` - matches aspects of the given type for all
 *  paths.
 *  * `*@path` - matches aspects of all types on the given path.
 *  The service will not remove existing aspects matching the syntax unless
 *  `delete_missing_aspects` is set to true.
 *  If this field is left empty, the service treats it as specifying
 *  exactly those Aspects present in the request.
 */
// const aspectKeys = ['abc','def']

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callUpdateEntry() {
  // Construct request
  const request = {
    entry,
  };

  // Run request
  const response = await dataplexClient.updateEntry(request);
  console.log(response);
}

callUpdateEntry();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

from google.cloud import dataplex_v1
from google.protobuf import struct_pb2


def update_entry(
    project_id: str, location: str, entry_group_id: str, entry_id: str
) -> dataplex_v1.Entry:
    """Method to update Entry located in project_id, location, entry_group_id and with entry_id"""

    # Initialize client that will be used to send requests across threads. This
    # client only needs to be created once, and can be reused for multiple requests.
    # After completing all of your requests, call the "__exit__()" method to safely
    # clean up any remaining background resources. Alternatively, use the client as
    # a context manager.
    with dataplex_v1.CatalogServiceClient() as client:
        # The resource name of the Entry
        name = f"projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}"
        entry = dataplex_v1.Entry(
            name=name,
            entry_source=dataplex_v1.EntrySource(
                description="updated description of the entry"
            ),
            aspects={
                "dataplex-types.global.generic": dataplex_v1.Aspect(
                    aspect_type="projects/dataplex-types/locations/global/aspectTypes/generic",
                    data=struct_pb2.Struct(
                        fields={
                            # "Generic" Aspect Type have fields called "type" and "system.
                            # The values below are a sample of possible options.
                            "type": struct_pb2.Value(
                                string_value="updated example value"
                            ),
                            "system": struct_pb2.Value(
                                string_value="updated example system"
                            ),
                        }
                    ),
                )
            },
        )

        # Update mask specifies which fields will be updated.
        # For more information on update masks, see: https://google.aip.dev/161
        update_mask = {"paths": ["aspects", "entry_source.description"]}
        return client.update_entry(entry=entry, update_mask=update_mask)


if __name__ == "__main__":
    # TODO(developer): Replace these variables before running the sample.
    project_id = "MY_PROJECT_ID"
    # Available locations: https://cloud.google.com/dataplex/docs/locations
    location = "MY_LOCATION"
    entry_group_id = "MY_ENTRY_GROUP_ID"
    entry_id = "MY_ENTRY_ID"

    updated_entry = update_entry(project_id, location, entry_group_id, entry_id)
    print(f"Successfully updated entry: {updated_entry.name}")

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

항목 객체에 관점을 추가하려면 #required_aspects=를 참고하세요.

REST

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

각 관점 유형과 항목이 서로 다른 Google Cloud 조직에 있는 항목에서 관점을 만들고 사용할 수 없습니다.

재사용 가능한 시스템 관점 유형의 관점 연결

재사용 가능한 시스템 관점 유형의 관점을 항목에 연결할 수 있습니다.

구조에 따라 Google Cloud 콘솔에서 재사용 가능한 측면 유형의 측면을 수정할 수 있습니다. 중첩된 필드가 포함된 관점 유형은 Google Cloud 콘솔에서 수정이 지원되지 않습니다. gcloud 명령줄 도구 또는 REST API를 사용하여 이 유형의 측면을 연결하거나 업데이트해야 합니다.

데이터 품질 스코어카드

데이터 품질 스코어카드는 데이터 품질 스캔 또는 기타 프로세스를 기반으로 데이터 품질을 요약하는 측면입니다. 항목에 데이터 품질 스코어카드를 첨부하여 맞춤 데이터 품질 정보를 제공할 수 있습니다. 이렇게 하려면 시스템 정의 유형 data-quality-scorecard의 관점을 연결합니다.

data-quality-scorecard 측면의 data 필드에는 다음 필드가 포함될 수 있습니다.

job: 선택사항. 스코어카드를 생성한 작업에 관한 세부정보가 포함된 레코드입니다.
- name: 데이터 품질 작업의 리소스 이름입니다.
- runTime: 데이터 품질 작업의 실행 시간입니다.
score: 선택사항. 전반적인 데이터 품질 점수입니다. 점수 범위는 [0, 100]입니다.
status: (필수사항) 데이터 품질 스코어카드의 상태로, 품질 기준 (PASS 또는 FAIL)을 통과했는지 또는 실패했는지를 나타냅니다.
dimensions: 선택사항. 측정기준 결과의 배열입니다. 각 결과에는 다음이 포함됩니다.
- name: 측정기준의 이름입니다. ACCURACY, COMPLETENESS, CONSISTENCY, FRESHNESS, UNIQUENESS, VALIDITY, VOLUME 중 하나이거나 맞춤 측정기준 이름일 수 있습니다. 맞춤 측정기준 이름은 대문자를 사용해야 하며 30자 이하여야 합니다.
- score: 전체 차원 수준 점수입니다(범위: [0, 100]).
- status: 측정기준의 상태로, 품질 기준 (PASS 또는 FAIL)을 통과했는지 여부를 나타냅니다.
columns: 선택사항. 열 결과의 배열입니다. 각 결과에는 다음이 포함됩니다.
- name: 열 이름입니다.
- score: 전체 열 수준 점수입니다(범위: [0, 100]).
- status: 열의 상태로, 품질 기준 (PASS 또는 FAIL)을 통과했는지 여부를 나타냅니다.
- dimensions: 열의 측정기준 점수 배열입니다. 각 차원 점수에는 다음이 포함됩니다.
  - name: 측정기준의 이름입니다.
  - score: 측정기준의 점수입니다(범위: [0, 100]).
  - status: 열의 측정기준 상태로, 품질 기준 (PASS 또는 FAIL)을 통과했는지 여부를 나타냅니다.

관점을 연결하는 명령어를 실행하면 해당 관점의 기존 데이터가 대체됩니다. 예를 들어 점수가 80인 스코어카드를 점수가 90인 새 파일로 업데이트하면 80가 덮어쓰여집니다. 데이터를 병합하지는 않습니다.

데이터 품질 스코어카드를 첨부하려면 다음 단계를 따르세요.

gcloud

항목의 관점을 업데이트하려면 gcloud dataplex entries update-aspects 명령어를 사용합니다.

다음 콘텐츠로 JSON 파일 (dq-aspect.json)을 만듭니다.

  {
    "dataplex-types.global.data-quality-scorecard": {
      "data": {
        "score": 0.8,
        "status": "PASS",
        "dimensions": [
          {
            "name": "completeness",
            "score": 0.9,
            "status": "PASS"
          },
          {
            "name": "uniqueness",
            "score": 0.7,
            "status": "FAIL"
          }
        ],
        "columns": [
          {
            "name": "col1",
            "score": 0.85,
            "status": "PASS"
          }
        ]
      }
    }
  }
}

다음 명령어를 실행합니다.
```
  gcloud dataplex entries update-aspects ENTRY_ID
  --location=LOCATION
  --entry-group=ENTRY_GROUP_ID
  --project=PROJECT_ID
  --aspects=dq-aspect.json
```
다음 변수를 바꿉니다.
- ENTRY_ID: 항목의 ID입니다(예: example-entry).
- LOCATION: 항목의 위치(예: us-central1)
- ENTRY_GROUP_ID: 항목 그룹의 ID입니다(예: example-entry-group).
- PROJECT_ID: 프로젝트 ID입니다(예: example-project).

REST

항목의 관점을 업데이트하려면 entry.patch 메서드를 사용합니다.

payload.json 파일을 만들고 요청의 JSON 콘텐츠를 여기에 붙여넣습니다.


  {
    "aspects": {
      "dataplex-types.global.data-quality-scorecard": {
        "data": {
          "score": 80,
          "status": "PASS",
          "dimensions": [
            {
              "name": "completeness",
              "score": 90,
              "status": "PASS"
            },
            {
              "name": "uniqueness",
              "score": 70,
              "status": "FAIL"
            }
          ],
          "columns": [
            {
              "name": "col1",
              "score": 85,
              "status": "PASS"
            }
          ]
        }
      }
    }
  }

터미널에서 다음 명령어를 실행합니다.

 curl -X PATCH \
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json" \
 -d @payload.json \
 "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"

다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID입니다(예: example-project).
LOCATION: 항목의 위치입니다(예: us-central1).
ENTRY_GROUP_ID: 항목 그룹의 ID(예: example-entry-group)
ENTRY_ID: 항목의 ID입니다(예: example-entry).

기타 재사용 가능한 관점 유형

다음 시스템 측면 유형도 사용할 수 있습니다. 데이터 품질 스코어카드에 표시된 것과 동일한 gcloud 또는 REST API 메서드를 사용하여 첨부할 수 있습니다. 중첩된 필드가 없는 측면 유형(예: generic)의 경우 콘솔을 사용할 수 있습니다.

Contacts. contacts 관점 유형을 사용하여 소유권 또는 관리권을 할당합니다. 필드에는 다음이 포함됩니다.
- identities (배열): 연락처 목록입니다. 각 연락처에는 다음이 포함됩니다.
  - role (문자열): 연락처의 역할입니다 (예: owner, steward, producer, admin).
  - name (문자열): 연락처 이름입니다.
  - id (문자열): 연락처의 이메일 주소 또는 ID입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
 {
   "aspects": {
     "dataplex-types.global.contacts": {
       "data": {
         "identities": [
           {
             "role": "steward",
             "name": "Jane Doe",
             "id": "jane.doe@example.com"
           }
         ]
       }
     }
   }
 }
```
데이터 프로필. data-profile 관점 유형을 사용하여 데이터 프로파일링 결과를 캡처합니다. 자세한 내용은 데이터 프로파일링 정보를 참고하세요.

필드에는 다음이 포함됩니다.
- sourceDataInfo (레코드): 프로필을 생성하기 위해 스캔된 소스 데이터에 관한 정보입니다.
  - scope (열거형): 프로필의 범위 (PREVIEW, SAMPLED 또는 ALL). PREVIEW 값은 경량 프로파일링 스캔의 결과에 해당합니다.
  - scannedRows (정수): 스캔된 행 수입니다.
  - samplingPercentage (double): 사용된 샘플링 비율입니다.
- fields (지도): uniqueness, nullness, topN 값과 numeric, string, datetime, array 열의 유형별 통계를 비롯한 데이터 프로필의 열 이름 지도입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
 {
   "aspects": {
     "dataplex-types.global.data-profile": {
       "data": {
         "sourceDataInfo": {
         "scope": "ALL",
         "scannedRows": 100
       },
       "fields": {
         "col1": {
           "nullness": 0.0,
           "uniqueness": 0.1,
      "string": {
        "length": {
          "min": 1,
          "max": 20,
          "avg": 12.54
        }
      }
         }
       }
     }
   }
 }}
```
그래프 프로필 graph-profile 관점 유형 (dataplex-types.global.graph-profile)은 비정형 데이터 통계에서 추론된 시맨틱 구조 (노드, 가장자리, 필드)를 포착하는 AI 생성 시스템 관점입니다. Knowledge Catalog는 스캔 실행 중에 이 측면을 자동으로 연결하지만 REST API를 사용하여 추론된 통계를 수동으로 업데이트하거나 구체화할 수 있습니다. 자세한 안내와 페이로드 예시는 추론된 통계 업데이트를 참고하세요.
일반 일반 항목 정보에는 generic 관점 유형을 사용합니다. 필드에는 다음이 포함됩니다.
- type (문자열): 사용자가 지정한 유형을 저장하는 자유 형식 필드입니다.
- system (문자열): 맞춤 항목의 시스템입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
{
  "aspects": {
    "dataplex-types.global.generic": {
      "data": {
        "type": "custom-type",
        "system": "custom-system"
      }
    }
  }
}
```
개요. overview 관점 유형을 사용하여 서식 있는 텍스트 설명을 제공합니다. 필드에는 다음이 포함됩니다.
- content (문자열): HTML 형식을 지원하는 항목 개요입니다.
- links (배열): 소스 시스템 링크 목록입니다. 각 링크에는 다음이 포함됩니다.
  - url (문자열): 링크의 URL입니다.
  - title (문자열): 링크의 제목입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
{
  "aspects": {
    "dataplex-types.global.overview": {
      "data": {
        "content": "This is a <b>rich text</b> description.",
      "links": [
        {
          "url": "https://example.com",
          "title": "Example Link"
        }
      ]
    }
  }
}}
```
스키마. schema 관점 유형을 사용하여 데이터 구조를 설명합니다.
- fields (배열): 스키마 필드의 목록입니다. 필드에는 다음이 포함됩니다.
  - name (문자열): 필드의 이름입니다.
  - dataType (문자열): 필드의 데이터 유형입니다.
  - metadataType (열거형): 메타데이터 유형 (예: STRING, BOOLEAN)입니다.
  - mode (열거형): 필드의 모드입니다 (NULLABLE, REQUIRED, REPEATED).
  - description (문자열): 필드에 대한 설명입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
{
  "aspects": {
    "dataplex-types.global.schema": {
      "data": {
        "fields": [
        {
          "name": "id",
          "dataType": "string",
          "metadataType": "STRING",
          "mode": "REQUIRED"
        }
      ]
    }
  }
}}
```
사용. usage 관점 유형을 사용하여 사용량 측정항목을 추적합니다. 필드에는 다음이 포함됩니다.
- metrics (배열): 사용량 측정항목 목록입니다. 각 측정항목에는 다음이 포함됩니다.
  - name (문자열): 측정항목의 이름입니다 (예: views, reads).
  - timeSeries (배열): 시계열 데이터 목록입니다. 각 항목에는 다음이 포함됩니다.
    - interval (문자열): 집계 간격입니다 (예: 30d).
    - value (정수): 집계된 값입니다.
- refreshTime (datetime): 측정항목이 마지막으로 새로고침된 시간입니다.
다음과 같이 payload.json 파일을 만듭니다.
```
{
  "aspects": {
    "dataplex-types.global.usage": {
      "data": {
        "metrics": [
        {
          "name": "views",
          "timeSeries": [
            {
              "interval": "30d",
              "value": 100
            }
          ]
        }
      ],
      "refreshTime": "2025-01-01T12:00:00Z"
    }
  }
}}
```

항목 링크 만들기

항목 링크를 만들어 두 항목 간의 관계를 설정할 수 있습니다.

진입 링크는 synonym와 같은 대칭일 수도 있고 definition와 같은 비대칭일 수도 있습니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for CreateEntryLink</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CreateEntryLinkRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        CreateEntryLinkRequest request = new CreateEntryLinkRequest
        {
            ParentAsEntryGroupName = EntryGroupName.FromProjectLocationEntryGroup("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]"),
            EntryLinkId = "",
            EntryLink = new EntryLink(),
        };
        // Make the request
        EntryLink response = catalogServiceClient.CreateEntryLink(request);
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateEntryLinkRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateEntryLinkRequest.
	}
	resp, err := c.CreateEntryLink(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.CreateEntryLinkRequest;
import com.google.cloud.dataplex.v1.EntryGroupName;
import com.google.cloud.dataplex.v1.EntryLink;

public class SyncCreateEntryLink {

  public static void main(String[] args) throws Exception {
    syncCreateEntryLink();
  }

  public static void syncCreateEntryLink() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      CreateEntryLinkRequest request =
          CreateEntryLinkRequest.newBuilder()
              .setParent(EntryGroupName.of("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]").toString())
              .setEntryLinkId("entryLinkId-1349584441")
              .setEntryLink(EntryLink.newBuilder().build())
              .build();
      EntryLink response = catalogServiceClient.createEntryLink(request);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The resource name of the parent Entry Group:
 *  `projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}`.
 */
// const parent = 'abc123'
/**
 *  Required. Entry Link identifier
 *  * Must contain only lowercase letters, numbers and hyphens.
 *  * Must start with a letter.
 *  * Must be between 1-63 characters.
 *  * Must end with a number or a letter.
 *  * Must be unique within the EntryGroup.
 */
// const entryLinkId = 'abc123'
/**
 *  Required. Entry Link resource.
 */
// const entryLink = {}

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callCreateEntryLink() {
  // Construct request
  const request = {
    parent,
    entryLinkId,
    entryLink,
  };

  // Run request
  const response = await dataplexClient.createEntryLink(request);
  console.log(response);
}

callCreateEntryLink();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_create_entry_link():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry_link = dataplex_v1.EntryLink()
    entry_link.entry_link_type = "entry_link_type_value"
    entry_link.entry_references.name = "name_value"
    entry_link.entry_references.type_ = "TARGET"

    request = dataplex_v1.CreateEntryLinkRequest(
        parent="parent_value",
        entry_link_id="entry_link_id_value",
        entry_link=entry_link,
    )

    # Make the request
    response = client.create_entry_link(request=request)

    # Handle the response
    print(response)

REST

필요한 측면으로 항목 링크를 만들려면 요청 본문에 측면 데이터를 포함하여 entryLinks.create 메서드를 사용합니다.

항목 링크에 관점 추가

항목 간 관계에 관한 정보로 메타데이터를 보강하려면 항목 링크에 관점을 추가하세요.

특정 관점이 필요하도록 항목 링크 유형을 구성할 수 있습니다. 이러한 유형의 항목 링크를 만들 때는 필수 관점을 제공해야 합니다.

항목 링크를 만들 때 또는 기존 항목 링크를 업데이트하여 다음과 같이 이러한 측면을 추가할 수 있습니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntryLink</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryLinkRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryLinkRequest request = new UpdateEntryLinkRequest
        {
            EntryLink = new EntryLink(),
            AllowMissing = false,
            AspectKeys = { "", },
        };
        // Make the request
        EntryLink response = catalogServiceClient.UpdateEntryLink(request);
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryLinkRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryLinkRequest.
	}
	resp, err := c.UpdateEntryLink(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.EntryLink;
import com.google.cloud.dataplex.v1.UpdateEntryLinkRequest;
import java.util.ArrayList;

public class SyncUpdateEntryLink {

  public static void main(String[] args) throws Exception {
    syncUpdateEntryLink();
  }

  public static void syncUpdateEntryLink() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryLinkRequest request =
          UpdateEntryLinkRequest.newBuilder()
              .setEntryLink(EntryLink.newBuilder().build())
              .setAllowMissing(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      EntryLink response = catalogServiceClient.updateEntryLink(request);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Entry Link resource.
 */
// const entryLink = {}
/**
 *  Optional. If set to true and the entry link doesn't exist, the service will
 *  create it.
 */
// const allowMissing = true
/**
 *  Optional. The map keys of the Aspects which the service should modify.
 *  It should be the aspect type reference in the format
 *  `{project_id_or_number}.{location_id}.{aspect_type_id}`.
 *  If this field is left empty, the service treats it as specifying
 *  exactly those Aspects present in the request.
 */
// const aspectKeys = ['abc','def']

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callUpdateEntryLink() {
  // Construct request
  const request = {
    entryLink,
  };

  // Run request
  const response = await dataplexClient.updateEntryLink(request);
  console.log(response);
}

callUpdateEntryLink();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_entry_link():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry_link = dataplex_v1.EntryLink()
    entry_link.entry_link_type = "entry_link_type_value"
    entry_link.entry_references.name = "name_value"
    entry_link.entry_references.type_ = "TARGET"

    request = dataplex_v1.UpdateEntryLinkRequest(
        entry_link=entry_link,
    )

    # Make the request
    response = client.update_entry_link(request=request)

    # Handle the response
    print(response)

REST

항목 링크를 업데이트하려면 entryLink 본문에 관점 데이터를 포함하여 entryLinks.patch 메서드를 사용합니다.

항목 링크와 함께 측면을 사용할 때는 다음 제한사항에 유의하세요.

선택적 관점은 지원되지 않습니다.
데이터 관점은 지원되지 않습니다.
맞춤 유형의 측면은 지원되지 않습니다.
schema-join와 같은 시스템 관점 유형으로 정의된 필수 관점만 관리할 수 있습니다.
측면의 콘텐츠를 기반으로 항목 링크를 검색하는 것은 지원되지 않습니다.
항목 링크 측면 가져오기 또는 내보내기는 지원되지 않습니다.

항목의 기존 관점 관리

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

관점 업데이트

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

BigQuery 테이블과 같은 퍼스트 파티 (1P) 시스템 항목의 경우 modifyEntry API를 사용하여 측면을 업데이트할 수 있습니다. 이를 통해 소스 시스템의 메타데이터 업데이트 권한 (예: BigQueryData 편집자)을 사용할 수 있습니다.

콘솔

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

검색 페이지로 이동
검색 플랫폼이 Data Catalog로 설정되어 있는 경우 검색 플랫폼 선택 메뉴에서 Dataplex Universal Catalog를 선택합니다.
업데이트할 관점이 있는 항목을 검색하고 항목을 클릭합니다.

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

세부정보 탭을 클릭합니다.
태그 및 관점 섹션에서 업데이트하려는 관점이나 태그를 펼치고 수정을 클릭합니다.
관점 수정 창에서 필수 입력란을 업데이트합니다.
저장을 클릭합니다.

gcloud

항목이나 항목 열에 대한 관점을 업데이트하려면 gcloud dataplex entries update 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

  public static void main(String[] args) throws Exception {
    syncUpdateEntry();
  }

  public static void syncUpdateEntry() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Entry resource.
 */
// const entry = {}
/**
 *  Optional. Mask of fields to update. To update Aspects, the update_mask must
 *  contain the value "aspects".
 *  If the update_mask is empty, the service will update all modifiable fields
 *  present in the request.
 */
// const updateMask = {}
/**
 *  Optional. If set to true and the entry doesn't exist, the service will
 *  create it.
 */
// const allowMissing = true
/**
 *  Optional. If set to true and the aspect_keys specify aspect ranges, the
 *  service deletes any existing aspects from that range that weren't provided
 *  in the request.
 */
// const deleteMissingAspects = true
/**
 *  Optional. The map keys of the Aspects which the service should modify. It
 *  supports the following syntaxes:
 *  * `<aspect_type_reference>` - matches an aspect of the given type and empty
 *  path.
 *  * `<aspect_type_reference>@path` - matches an aspect of the given type and
 *  specified path. For example, to attach an aspect to a field that is
 *  specified by the `schema` aspect, the path should have the format
 *  `Schema.<field_name>`.
 *  * `<aspect_type_reference>@*` - matches aspects of the given type for all
 *  paths.
 *  * `*@path` - matches aspects of all types on the given path.
 *  The service will not remove existing aspects matching the syntax unless
 *  `delete_missing_aspects` is set to true.
 *  If this field is left empty, the service treats it as specifying
 *  exactly those Aspects present in the request.
 */
// const aspectKeys = ['abc','def']

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callUpdateEntry() {
  // Construct request
  const request = {
    entry,
  };

  // Run request
  const response = await dataplexClient.updateEntry(request);
  console.log(response);
}

callUpdateEntry();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

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

관점 삭제

콘솔

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

검색 페이지로 이동
검색 플랫폼이 Data Catalog로 설정되어 있는 경우 검색 플랫폼 선택 메뉴에서 Dataplex Universal Catalog를 선택합니다.
삭제하려는 관점이 있는 항목을 검색하고 항목을 클릭합니다.

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

세부정보 탭을 클릭합니다.
태그 및 관점 섹션에서 삭제하려는 관점이나 태그를 펼치고 삭제를 클릭합니다.
확인을 클릭합니다.

gcloud

항목 관점을 삭제하려면 gcloud dataplex entries update 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

  public static void main(String[] args) throws Exception {
    syncUpdateEntry();
  }

  public static void syncUpdateEntry() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Entry resource.
 */
// const entry = {}
/**
 *  Optional. Mask of fields to update. To update Aspects, the update_mask must
 *  contain the value "aspects".
 *  If the update_mask is empty, the service will update all modifiable fields
 *  present in the request.
 */
// const updateMask = {}
/**
 *  Optional. If set to true and the entry doesn't exist, the service will
 *  create it.
 */
// const allowMissing = true
/**
 *  Optional. If set to true and the aspect_keys specify aspect ranges, the
 *  service deletes any existing aspects from that range that weren't provided
 *  in the request.
 */
// const deleteMissingAspects = true
/**
 *  Optional. The map keys of the Aspects which the service should modify. It
 *  supports the following syntaxes:
 *  * `<aspect_type_reference>` - matches an aspect of the given type and empty
 *  path.
 *  * `<aspect_type_reference>@path` - matches an aspect of the given type and
 *  specified path. For example, to attach an aspect to a field that is
 *  specified by the `schema` aspect, the path should have the format
 *  `Schema.<field_name>`.
 *  * `<aspect_type_reference>@*` - matches aspects of the given type for all
 *  paths.
 *  * `*@path` - matches aspects of all types on the given path.
 *  The service will not remove existing aspects matching the syntax unless
 *  `delete_missing_aspects` is set to true.
 *  If this field is left empty, the service treats it as specifying
 *  exactly those Aspects present in the request.
 */
// const aspectKeys = ['abc','def']

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callUpdateEntry() {
  // Construct request
  const request = {
    entry,
  };

  // Run request
  const response = await dataplexClient.updateEntry(request);
  console.log(response);
}

callUpdateEntry();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

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

항목 링크의 기존 관점 관리

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

관점 업데이트

항목 링크의 경우 재사용 가능한 시스템 관점 유형을 사용하는 필수 관점만 업데이트할 수 있습니다.

자세한 내용은 항목 링크 작업에 필요한 IAM 권한을 참고하세요.

REST

필수 관점으로 항목 링크를 업데이트하려면 요청 본문에 관점 데이터를 포함하여 entryLinks.patch 메서드를 사용합니다.

관점 삭제

항목 링크의 필수 관점은 삭제할 수 없습니다.

관점 유형 관리

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

사용 가능한 관점 유형 및 태그 템플릿 목록 보기

콘솔

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

메타데이터 유형으로 이동
관점 유형 및 태그 템플릿 탭을 클릭합니다.

이 페이지에는 사용 가능한 모든 Knowledge Catalog 관점 유형과 Data Catalog 태그 템플릿이 나열됩니다.

커스텀 관점 유형 및 태그 템플릿을 보려면 커스텀 탭을 클릭합니다. 맞춤 탭의 카탈로그 소스 열에는 리소스가 있는 위치(Knowledge Catalog 또는 Data Catalog)가 표시됩니다.

시스템 관점 유형을 보려면 시스템 탭을 클릭합니다.

커스텀 관점 유형과 시스템 관점 유형에 대한 상세 설명은 이 문서의 관점 유형 카테고리 섹션을 참고하세요.

선택사항: 선택한 프로젝트의 관점 유형 및 태그 템플릿 목록을 보려면 커스텀 탭을 클릭한 다음 모든 프로젝트에서 표시 전환 버튼을 클릭하여 사용 안함으로 전환합니다.

모든 프로젝트에서 표시 전환 버튼은 기본적으로 사용 설정되어 있으며 목록에는 선택한 조직의 Knowledge Catalog 리소스와 액세스할 수 있는 모든 조직의 Data Catalog 리소스가 포함됩니다.

gcloud

사용 가능한 모든 관점 유형을 나열하려면 gcloud dataplex aspect-types list 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for ListAspectTypes</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void ListAspectTypesRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        ListAspectTypesRequest request = new ListAspectTypesRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Filter = "",
            OrderBy = "",
        };
        // Make the request
        PagedEnumerable<ListAspectTypesResponse, AspectType> response = catalogServiceClient.ListAspectTypes(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (AspectType item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (ListAspectTypesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (AspectType item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<AspectType> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (AspectType item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.ListAspectTypesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#ListAspectTypesRequest.
	}
	it := c.ListAspectTypes(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.ListAspectTypesResponse)
	}
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.ListAspectTypesRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncListAspectTypes {

  public static void main(String[] args) throws Exception {
    syncListAspectTypes();
  }

  public static void syncListAspectTypes() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      ListAspectTypesRequest request =
          ListAspectTypesRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .setOrderBy("orderBy-1207110587")
              .build();
      for (AspectType element : catalogServiceClient.listAspectTypes(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The resource name of the AspectType location, of the form:
 *  `projects/{project_number}/locations/{location_id}`
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Optional. Maximum number of AspectTypes to return. The service may return
 *  fewer than this value. If unspecified, the service returns at most 10
 *  AspectTypes. The maximum value is 1000; values above 1000 will be coerced
 *  to 1000.
 */
// const pageSize = 1234
/**
 *  Optional. Page token received from a previous `ListAspectTypes` call.
 *  Provide this to retrieve the subsequent page. When paginating, all other
 *  parameters you provide to `ListAspectTypes` must match the call that
 *  provided the page token.
 */
// const pageToken = 'abc123'
/**
 *  Optional. Filter request. Filters are case-sensitive.
 *  The service supports the following formats:
 *  * labels.key1 = "value1"
 *  * labels:key1
 *  * name = "value"
 *  These restrictions can be conjoined with AND, OR, and NOT conjunctions.
 */
// const filter = 'abc123'
/**
 *  Optional. Orders the result by `name` or `create_time` fields.
 *  If not specified, the ordering is undefined.
 */
// const orderBy = 'abc123'

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callListAspectTypes() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = dataplexClient.listAspectTypesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListAspectTypes();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_list_aspect_types():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.ListAspectTypesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_aspect_types(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the list_aspect_types call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#list_aspect_types.
#
def list_aspect_types
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::ListAspectTypesRequest.new

  # Call the list_aspect_types method.
  result = client.list_aspect_types request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::AspectType.
    p item
  end
end

REST

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

관점 유형 또는 태그 템플릿 세부정보 보기

콘솔

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

메타데이터 유형으로 이동
관점 유형 및 태그 템플릿 탭을 클릭합니다.
Knowledge Catalog 관점 유형의 세부정보를 보려면 관점 유형을 클릭합니다. 관점 유형 세부정보 페이지가 열리고 여기에서 표시 이름, 관점 유형 ID, 설명, 프로젝트 ID, 위치, 라벨, 생성일, 최종 수정일과 같은 세부정보에 액세스할 수 있습니다.
- 선택한 관점 유형의 구조를 보려면 템플릿 탭을 클릭합니다.
- 최근에 생성된 관련 항목 10개 목록을 보려면 샘플 항목 탭을 클릭합니다.
- 관련 항목을 모두 검색하려면 검색에 관련 항목 모두 표시를 클릭합니다. 이 버튼은 관련 항목이 최소 하나 이상 있는 경우에만 표시됩니다.
Data Catalog 태그 템플릿 세부정보를 보려면 태그 템플릿을 클릭합니다. 태그 템플릿 세부정보 페이지가 Data Catalog에서 열리며 여기에서 표시 이름, 템플릿 ID, 프로젝트 ID, 위치, 공개 상태, 라벨과 같은 세부정보에 액세스할 수 있습니다.

gcloud

관점 유형 세부정보를 가져오려면 gcloud dataplex aspect-types describe 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for GetAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void GetAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        GetAspectTypeRequest request = new GetAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
        };
        // Make the request
        AspectType response = catalogServiceClient.GetAspectType(request);
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.GetAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#GetAspectTypeRequest.
	}
	resp, err := c.GetAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.GetAspectTypeRequest;

public class SyncGetAspectType {

  public static void main(String[] args) throws Exception {
    syncGetAspectType();
  }

  public static void syncGetAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      GetAspectTypeRequest request =
          GetAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .build();
      AspectType response = catalogServiceClient.getAspectType(request);
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The resource name of the AspectType:
 *  `projects/{project_number}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
 */
// const name = 'abc123'

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callGetAspectType() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await dataplexClient.getAspectType(request);
  console.log(response);
}

callGetAspectType();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_get_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.GetAspectTypeRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_aspect_type(request=request)

    # Handle the response
    print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the get_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#get_aspect_type.
#
def get_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::GetAspectTypeRequest.new

  # Call the get_aspect_type method.
  result = client.get_aspect_type request

  # The returned object is of type Google::Cloud::Dataplex::V1::AspectType.
  p result
end

REST

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

커스텀 관점 유형 업데이트

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

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

콘솔

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

메타데이터 유형으로 이동
관점 유형 및 태그 템플릿 탭을 클릭합니다.
업데이트할 관점 유형을 클릭합니다.
관점 유형 세부정보 페이지에서 수정을 클릭합니다.
필요에 따라 표시 이름, 설명, 템플릿 필드, 라벨을 수정합니다.
선택사항: 관점 유형의 필드를 지원 중단됨으로 표시하려면 다음 단계를 따르세요.
1. 템플릿 섹션에서 필드를 펼칩니다.
2. 지원 중단됨을 선택합니다.
3. 지원 중단 이유 필드에 선택한 필드의 지원 중단 이유를 입력합니다.
4. 완료를 클릭합니다.
5. 저장을 클릭합니다.

gcloud

커스텀 관점 유형을 업데이트하려면 gcloud dataplex aspect-types update 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateAspectTypeRequest request = new UpdateAspectTypeRequest
        {
            AspectType = new AspectType(),
            UpdateMask = new FieldMask(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.UpdateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceUpdateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateAspectTypeRequest.
	}
	op, err := c.UpdateAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.UpdateAspectTypeRequest;
import com.google.protobuf.FieldMask;

public class SyncUpdateAspectType {

  public static void main(String[] args) throws Exception {
    syncUpdateAspectType();
  }

  public static void syncUpdateAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateAspectTypeRequest request =
          UpdateAspectTypeRequest.newBuilder()
              .setAspectType(AspectType.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.updateAspectTypeAsync(request).get();
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. AspectType Resource
 */
// const aspectType = {}
/**
 *  Required. Mask of fields to update.
 */
// const updateMask = {}
/**
 *  Optional. Only validate the request, but do not perform mutations.
 *  The default is false.
 */
// const validateOnly = true

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callUpdateAspectType() {
  // Construct request
  const request = {
    aspectType,
    updateMask,
  };

  // Run request
  const [operation] = await dataplexClient.updateAspectType(request);
  const [response] = await operation.promise();
  console.log(response);
}

callUpdateAspectType();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.UpdateAspectTypeRequest(
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.update_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_aspect_type.
#
def update_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateAspectTypeRequest.new

  # Call the update_aspect_type method.
  result = client.update_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

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

커스텀 관점 유형 삭제

콘솔

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

메타데이터 유형으로 이동
관점 유형 및 태그 템플릿 탭을 클릭합니다.
삭제하려는 관점 유형을 클릭합니다.
관점 유형 세부정보 페이지에서 삭제를 클릭합니다. 메시지가 표시되면 확인합니다.

gcloud

커스텀 관점 유형을 삭제하려면 gcloud dataplex aspect-types delete 명령어를 사용합니다.

C#

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for DeleteAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void DeleteAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        DeleteAspectTypeRequest request = new DeleteAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
            Etag = "",
        };
        // Make the request
        Operation<Empty, OperationMetadata> response = catalogServiceClient.DeleteAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<Empty, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Empty result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Empty, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceDeleteAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Empty retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.


//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.DeleteAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#DeleteAspectTypeRequest.
	}
	op, err := c.DeleteAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	err = op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
}

자바

Java

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

import com.google.cloud.dataplex.v1.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.DeleteAspectTypeRequest;
import com.google.protobuf.Empty;

public class SyncDeleteAspectType {

  public static void main(String[] args) throws Exception {
    syncDeleteAspectType();
  }

  public static void syncDeleteAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      DeleteAspectTypeRequest request =
          DeleteAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .setEtag("etag3123477")
              .build();
      catalogServiceClient.deleteAspectTypeAsync(request).get();
    }
  }
}

Node.js

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The resource name of the AspectType:
 *  `projects/{project_number}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
 */
// const name = 'abc123'
/**
 *  Optional. If the client provided etag value does not match the current etag
 *  value, the DeleteAspectTypeRequest method returns an ABORTED error
 *  response.
 */
// const etag = 'abc123'

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callDeleteAspectType() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const [operation] = await dataplexClient.deleteAspectType(request);
  const [response] = await operation.promise();
  console.log(response);
}

callDeleteAspectType();

Python

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_delete_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.DeleteAspectTypeRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.

require "google/cloud/dataplex/v1"

##
# Snippet for the delete_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#delete_aspect_type.
#
def delete_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::DeleteAspectTypeRequest.new

  # Call the delete_aspect_type method.
  result = client.delete_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

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

다음 단계

Knowledge Catalog에서 리소스를 검색하는 방법 알아보기
항목 관리 및 커스텀 소스 수집 방법 알아보기
Knowledge Catalog로 메타데이터를 가져오는 방법 알아보기
Knowledge Catalog의 메타데이터 자세히 알아보기
Data Catalog에서 Knowledge Catalog로 전환하는 방법 자세히 알아보기
기본 데이터 컨텍스트를 설정하는 방법을 알아봅니다.
Knowledge Catalog 사용 사례 사용해 보기

관점 관리 및 메타데이터 보강 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

관점 유형이란 무엇인가요?

관점 유형 카테고리

커스텀 관점 유형

시스템 관점 유형

관점이란 무엇인가요?

측면 배치 및 타겟 수준

관점 카테고리

필수 관점

선택적 관점

데이터 관점

시작하기 전에

필요한 역할

API 사용 설정

커스텀 관점 유형 만들기

콘솔

gcloud

C#

C#

Go

Go

자바

Java

Node.js

Node.js

Python

Python

Ruby

Ruby

REST

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

항목에 관점 추가

콘솔

gcloud

C#

C#

Go

Go

자바

Java

Node.js

Node.js

Python

Python

Ruby

Ruby

REST

재사용 가능한 시스템 관점 유형의 관점 연결

데이터 품질 스코어카드

gcloud

REST

기타 재사용 가능한 관점 유형

항목 링크 만들기

C#

C#

Go

Go

자바

Java

Node.js

Node.js

Python

Python

REST

항목 링크에 관점 추가

C#

C#

Go

Go

자바

Java

Node.js

Node.js

Python

Python

REST

항목의 기존 관점 관리

관점 업데이트

콘솔

gcloud

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