Dataplex Universal Catalog를 사용하여 AlloyDB 리소스 관리

메타데이터를 저장, 관리, 액세스할 수 있는 플랫폼인 Dataplex Universal Catalog를 사용하여 PostgreSQL용 AlloyDB 리소스를 검색하고 관리할 수 있습니다. Dataplex Universal Catalog를 사용하여 AlloyDB 메타데이터를 탐색하고 파악할 수 있습니다. Dataplex Universal Catalog를 사용하여 다음을 수행할 수 있습니다.

사용 사례의 종속 항목과 적합성 등의 분석
변경 관리
스키마 개선

Dataplex Universal Catalog는 AlloyDB에서 다음 메타데이터를 자동으로 검색합니다.

리소스 유형	검색한 메타데이터
클러스터, 데이터베이스, 인스턴스	이름 위치(리전)
스키마, 열, 테이블, 뷰	이름 위치(리전) 설명 스키마

리소스 유형

검색한 메타데이터

클러스터, 데이터베이스, 인스턴스

이름

위치(리전)

스키마, 열, 테이블, 뷰

이름

위치(리전)

설명

스키마

메타데이터 탐색 유형

Dataplex Universal Catalog의 컨텍스트에서 메타데이터 탐색은 Dataplex Universal Catalog가 연결된 데이터 소스(예: AlloyDB)를 스캔하여 데이터 애셋(예: 테이블, 뷰, 데이터베이스)을 식별하고 기술 메타데이터(예: 스키마, 설명, 위치)를 카탈로그로 추출하는 자동화된 프로세스입니다.

이 프로세스는 카탈로그가 소스 시스템과 동기화된 상태로 유지되도록 주기적으로 실행됩니다. AlloyDB에서는 클러스터와 인스턴스 메타데이터가 기본적으로 탐색되는 반면 데이터베이스, 스키마, 테이블, 뷰 메타데이터는 클러스터에서 통합을 사용 설정한 경우에만 탐색됩니다.

키워드 및 자연어 검색

Dataplex Universal Catalog에서는 키워드 검색과 자연어 검색을 지원합니다.

키워드 검색을 사용하면 특정 키워드, 필터, 정의된 구문을 사용하여 리소스를 찾을 수 있습니다. 예를 들어 system=AlloyDB AND type=Database를 입력하여 모든 AlloyDB 데이터베이스를 볼 수 있습니다.
자연어 검색(프리뷰)은 AI를 사용하여 시맨틱 쿼리를 이해합니다. 일상적인 언어를 사용하여 리소스를 찾을 수 있으므로 복잡한 구문이 필요 없습니다. 예를 들어 List all AlloyDB tables related to sales와 같은 쿼리를 입력할 수 있습니다.

자세한 내용은 Dataplex Universal Catalog 검색 구문을 참조하세요.

예: AlloyDB 데이터베이스 스키마 탐색

메타데이터 탐색 프로세스를 이해하기 위해 예시로 Dataplex Universal Catalog 통합이 사용 설정된 user-data-cluster라는 AlloyDB 클러스터를 가정해 보겠습니다. 이 클러스터의 기본 인스턴스 내에는 customers(id, email, signup_date) 테이블과 active_users(id, email) 뷰가 포함된 profiles 데이터베이스가 있습니다.

AlloyDB는 Dataplex Universal Catalog에 주기적으로 동기화되며 다음 리소스를 사용할 수 있습니다.

클러스터
열
데이터베이스
인스턴스
테이블
뷰

탐색이 완료되면 Google Cloud 콘솔의 Dataplex Universal Catalog 페이지에서 또는 API를 사용하여 이러한 애셋(customers 테이블 및 active_users)을 검색하고 스키마를 보며 추가 비즈니스 또는 운영 메타데이터로 보강할 수 있습니다.

관점을 사용하여 메타데이터 보강

관점 유형은 관점 템플릿으로 사용할 수 있는 재사용 가능한 리소스입니다. 관점 유형을 사용하면 작업과 불완전한 관점의 중복을 방지할 수 있습니다. Dataplex Universal Catalog를 사용하여 필요한 관점 유형을 만들 수 있습니다.

커스텀 관점 유형을 만든 후 관점을 AlloyDB 애셋에 연결할 수 있습니다. 관점을 AlloyDB 애셋에 연결하면 다음 작업을 수행할 수 있습니다.

애셋에 비즈니스 메타데이터 추가
비즈니스 메타데이터 및 기타 커스텀 메타데이터별로 애셋 검색

관점 유형을 만들고 관점을 AlloyDB에 연결하는 방법에 대한 자세한 내용은 관점 관리 및 메타데이터 보강을 참조하세요.

메타데이터 탐색 워크플로

기본적으로 클러스터와 인스턴스 리소스를 수집하여 탐색할 수 있습니다. 데이터베이스, 스키마, 테이블, 뷰 리소스를 수집하고 탐색하려면 AlloyDB 클러스터에 Dataplex Universal Catalog 통합만 사용 설정해야 합니다.

AlloyDB 데이터베이스, 스키마, 테이블, 뷰 리소스를 탐색하려면 새 클러스터를 만들거나 기존 클러스터를 업데이트할 때 AlloyDB API를 사용하여 AlloyDB 클러스터에 Dataplex Universal Catalog 통합을 사용 설정해야 합니다. 자세한 내용은 클러스터 및 클러스터의 기본 인스턴스 만들기를 참조하세요.
Google Cloud 콘솔의 Dataplex Universal Catalog 검색 페이지를 사용하여 AlloyDB 애셋을 검색합니다. 자세한 내용은 Dataplex Universal Catalog에서 리소스 검색을 참조하세요.
AlloyDB 애셋에 컨텍스트를 추가하려면 애셋에 관점을 연결하면 됩니다. 관점은 데이터 거버넌스 및 분석에 도움이 되는 커스텀 메타데이터 항목입니다. 예를 들어 관점을 사용하여 개인 식별 정보(PII)가 포함된 열에 라벨을 지정할 수 있습니다. 자세한 내용은 관점 관리 및 메타데이터 보강을 참조하세요.
이제 클러스터 > 데이터베이스 > 스키마 > 테이블 또는 뷰 > 열이라는 계층 구조에 따라 AlloyDB 리소스를 탐색할 수 있습니다. 이를 통해 데이터 환경을 자세히 볼 수 있습니다. 자세한 내용은 Dataplex Universal Catalog에서 리소스 검색을 참조하세요.

시작하기 전에

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Dataplex API 사용 설정
권한 확인.

항목을 검색하고 AlloyDB 애셋에 연결하려면 특정 Identity and Access Management(IAM) 역할과 권한이 필요합니다. 자세한 내용은 Dataplex Universal Catalog 필수 IAM 역할 및 권한을 참조하세요.

필요한 IAM 역할

이 섹션에서는 리소스를 검색하고 검색 결과에 액세스하는 데 필요한 역할과 권한을 설명합니다.

검색 결과에 액세스하는 데 필요한 역할

Dataplex Universal Catalog에서 AlloyDB 메타데이터를 검색하고 보려면 주 구성원에게 dataplex.projects.search 권한을 포함한 AlloyDB 리소스를 볼 수 있는 권한이 있어야 합니다.

사용자, 그룹 또는 서비스 계정과 같은 주 구성원에게 이러한 권한을 부여하려면 AlloyDB 리소스가 포함된 프로젝트에 대한 AlloyDB 뷰어(roles/alloydb.viewer) IAM 역할을 할당합니다.

Dataplex Universal Catalog 작업	AlloyDB 리소스	필요한 역할이나 권한
AlloyDB 리소스 검색	클러스터	`alloydb.clusters.get`
	열	`alloydb.databases.get`
	인스턴스	`alloydb.instances.get`
	데이터베이스	`alloydb.databases.get`
	테이블	`alloydb.databases.get`
	뷰	`alloydb.databases.get`

사전 정의된 AlloyDB 뷰어 역할을 사용하지 않으려면 alloydb.clusters.get, alloydb.instances.get, alloydb.databases.get 권한이 포함된 커스텀 역할을 할당하면 됩니다.

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요. AlloyDB IAM 역할에 대한 자세한 내용은 AlloyDB의 IAM 역할 및 권한을 참조하세요.

항목 검색에 필요한 역할

항목을 검색하려면 검색에 사용되는 프로젝트에 대한 다음 IAM 역할이 최소 하나 이상 필요합니다.

Dataplex Catalog 관리자(roles/dataplex.catalogAdmin)
Dataplex Catalog 편집자(roles/dataplex.catalogEditor)
Dataplex Catalog 뷰어(roles/dataplex.catalogViewer)

검색 결과에 대한 권한은 선택한 프로젝트와는 별도로 확인됩니다. 자세한 내용은 Dataplex Universal Catalog로 데이터 애셋 검색을 참조하세요.

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 사용 설정

데이터베이스, 스키마, 테이블, 뷰 리소스를 수집하고 탐색할 수 있게 하려면 AlloyDB API를 사용하여 클러스터를 만들거나 업데이트합니다. 이 통합을 사용 설정하면 데이터 플레인 메타데이터 데이터베이스, 스키마, 테이블, 뷰 리소스의 동기화가 사용 설정됩니다.

Dataplex Universal Catalog와 통합하려면 클러스터 수준 dataplexConfig 플래그를 사용합니다. 보조 클러스터의 데이터를 보려면 이 플래그를 별도로 사용 설정해야 합니다. 데이터베이스, 스키마, 테이블과 같은 AlloyDB 메타데이터를 Cloud Storage 버킷으로 내보내려면 enabled를 true로 설정합니다. 그러면 Dataplex Universal Catalog에서 이 데이터를 사용할 수 있습니다. 이 기능은 기본 인스턴스에만 적용됩니다.

클러스터를 만들 때 Dataplex Universal Catalog 통합 사용 설정

Dataplex Universal Catalog 통합이 사용 설정된 AlloyDB 클러스터를 만들려면 POST 메서드와 다음 URL을 사용합니다. 이 호출의 전체 파라미터 목록은 메서드: projects.locations.clusters.create를 참조하세요. 클러스터 설정에 대한 자세한 내용은 클러스터 및 인스턴스 설정 보기를 참조하세요.

클러스터 ID는 외부에 공개되므로 클러스터 ID에 민감한 정보나 개인 식별 정보를 포함하지 마세요. 클러스터 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

요청을 보내려면 요청 본문을 cluster_request.json 파일에 저장합니다.

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : true
  }
}

다음을 바꿉니다.

DATABASE_VERSION: 데이터베이스 버전의 열거형 문자열(예: POSTGRES_16)
INITIAL_USERNAME: 기본 postgres 사용자에 사용하는 사용자 이름
INITIAL_USER_PASSWORD: 기본 postgres 사용자에 사용하는 비밀번호

다음 HTTP 메서드와 URL을 사용합니다.

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
LOCATION_ID: 클러스터가 위치한 리전의 ID입니다.
CLUSTER_ID: 생성된 클러스터의 ID. 클러스터 ID는 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.

요청을 보내려면 다음 옵션 중 하나를 사용합니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

응답

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

AlloyDB 클러스터에 Dataplex Universal Catalog 통합 사용 설정

기존 클러스터의 특정 필드를 업데이트하려면 projects.locations.clusters resource에서 PATCH 메서드를 사용합니다.

다음 HTTP 메서드와 URL을 사용합니다.

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
CLUSTER_ID: 클러스터의 이름입니다.

JSON 요청 본문:

{
  "dataplexConfig": {
    "enabled": true
  }
}

요청을 보내려면 다음 옵션 중 하나를 사용합니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

응답

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 확인

기존 클러스터에서 Dataplex Universal Catalog 통합이 사용 설정되어 있는지 확인하려면 GET 메서드를 사용합니다.

다음 HTTP 메서드와 URL을 사용합니다.

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
CLUSTER_ID: 클러스터 ID입니다.

요청을 보내려면 다음 옵션 중 하나를 사용합니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

전체 클러스터 proto에 대한 JSON 응답이 표시됩니다. proto 내에서 dataplexConfig 메시지를 찾습니다.

{
"dataplexConfig":
  {
  "enabled": true
  }
}

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 비활성화

다음 예시를 사용하여 통합을 비활성화합니다. 이 기능을 사용 중지하면 클러스터와 인스턴스 메타데이터만 사용할 수 있습니다.

다음 HTTP 메서드와 URL을 사용합니다.

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
CLUSTER_ID: 클러스터 ID입니다.

JSON 요청 본문:

{
  "dataplexConfig": {
    "enabled": false
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

응답

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

관점을 통해 AlloyDB 애셋 보강

커스텀 관점 유형을 만든 후 관점을 AlloyDB 애셋에 연결할 수 있습니다. 관점을 AlloyDB 애셋에 연결하면 다음 작업을 수행할 수 있습니다.

애셋에 비즈니스 메타데이터 추가
비즈니스 메타데이터 및 기타 커스텀 메타데이터별로 애셋 검색

관점 유형을 만들고 관점을 AlloyDB에 연결하는 방법에 대한 자세한 내용은 관점 관리 및 메타데이터 보강을 참조하세요.

AlloyDB 애셋 검색

Google Cloud 콘솔의 Dataplex Universal Catalog 검색 페이지를 사용하여 AlloyDB 애셋을 검색합니다.

Dataplex Universal Catalog 검색 페이지로 이동합니다.

검색 페이지로 이동
검색 플랫폼 선택에서 Dataplex Universal Catalog를 선택합니다.
필터 패널에서 시스템을 클릭한 후 AlloyDB를 선택합니다.
선택사항. 유형 별칭에서 다음 유형 별칭 중 하나 이상을 선택하여 특정 유형의 AlloyDB 애셋으로 검색 결과를 필터링할 수 있습니다.
- 데이터베이스
- 데이터베이스 스키마
- 클러스터
- 인스턴스
- 서비스
- 표
- 뷰
참고: 서비스는 AlloyDB 인스턴스의 유형 별칭입니다.

쿼리를 사용하여 키워드 검색 수행

Dataplex Universal Catalog의 검색창을 사용하여 키워드 검색어를 수행할 수 있습니다. 예를 들어 system=AlloyDB AND type=Database를 입력하여 모든 AlloyDB 데이터베이스를 볼 수 있습니다.

자세한 내용은 Dataplex Universal Catalog 검색 구문을 참조하세요.

모든 AlloyDB 애셋을 보려면 system=AlloyDB를 입력합니다.

그런 다음 구체적인 키워드를 입력할 수 있습니다. 예를 들어 모든 AlloyDB 데이터베이스를 보려면 다음 명령어를 실행합니다.

system=AlloyDB AND type=Database

모든 AlloyDB 테이블을 보려면 다음 쿼리를 입력합니다.

system=AlloyDB AND type=Table

또한 복잡한 표현식에 괄호 및 논리 연산자 AND와 OR을 사용할 수도 있습니다. 검색창에서 사용할 수 있는 표현식에 대한 자세한 내용은 Dataplex Universal Catalog 구문 검색을 참조하세요.

특정 AlloyDB 애셋에 대한 검색어를 검색창에 직접 입력할 수 있습니다. 쿼리 문자열 형식은 다음과 같습니다.

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

다음을 바꿉니다.

QUERY_STRING: 다음 목록을 사용하여 쿼리할 AlloyDB 애셋 유형에 따라 쿼리 문자열을 식별합니다.
- alloydb-database
- alloydb-cluster
- alloydb-instance
- alloydb-table
- alloydb-schema
- alloydb-view

예시 쿼리는 다음과 같습니다.

type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

관점 유형별로 검색

Dataplex Universal Catalog에는 검색을 수행하는 데 사용할 수 있는 몇 가지 관점 유형이 기본 제공됩니다.

관점 유형별로 검색하려면 다음 단계를 수행합니다.

관점 패널에서 관점 유형 추가 메뉴를 클릭합니다.
선택사항. AlloyDB 액세스를 선택하여 AlloyDB 언어별로 결과를 필터링합니다.
다음 관점 유형 중에서 하나 이상을 선택하여 검색 결과를 해당 유형으로 제한합니다.
- AlloyDB 데이터베이스
- AlloyDB 클러스터
- AlloyDB 인스턴스
- AlloyDB 뷰
- AlloyDB 스키마
- AlloyDB 테이블
확인을 클릭합니다.
결과 테이블에서 애셋 이름을 클릭하여 해당 애셋의 메타데이터를 봅니다.
선택사항: 애셋을 개선하거나 봅니다. 다음 중 원하는 작업을 수행할 수 있습니다.
- 애셋에 대한 서식 있는 텍스트 설명을 추가하려면 개요에서 추가를 클릭합니다.
- 관점을 애셋에 연결하려면 관점에서 추가를 클릭합니다.
- 인스턴스의 구성원 데이터베이스를 보려면 항목 목록 탭을 클릭한 후 검색에 하위 항목 모두 표시를 클릭합니다. 항목 목록 탭이 표시되지 않으면 클러스터에 데이터베이스가 없는 것입니다.
- 항목 세부정보에서 애셋의 전체 세부정보를 봅니다. 항목 이름을 클릭하여 추가 항목으로 드릴다운합니다.

AlloyDB에서 자연어 검색

자연어 검색(프리뷰)은 AI를 사용하여 시맨틱 쿼리를 이해합니다. 일상적인 언어를 사용하여 리소스를 찾을 수 있으므로 복잡한 구문이 필요 없습니다. 예를 들어 List all AlloyDB tables related to sales와 같은 쿼리를 입력할 수 있습니다.

자세한 내용은 Dataplex Universal Catalog 검색 구문을 참조하세요.

AlloyDB에서 구문 검색

키워드 검색을 사용하면 특정 키워드, 필터, 정의된 구문을 사용하여 리소스를 찾을 수 있습니다. 예를 들어 system=AlloyDB AND type=Database를 입력하여 모든 AlloyDB 데이터베이스를 볼 수 있습니다.

자세한 내용은 Dataplex Universal Catalog 검색 구문을 참조하세요.

워크플로 예시 - 클러스터에서 열로 드릴다운

클러스터에서 열로 드릴다운하려면 다음 단계를 수행합니다.

Dataplex Universal Catalog 검색 페이지로 이동합니다.

검색 페이지로 이동
검색 플랫폼 선택 옵션에서 Dataplex Universal Catalog를 선택합니다.
필터 패널에서 시스템을 선택한 후 AlloyDB를 선택합니다. 또는 검색창에 system=AlloyDB을 입력합니다.
클러스터 이름을 선택합니다.
AlloyDB 세부정보 페이지에서 항목 목록 탭을 클릭한 후 검색에 하위 항목 모두 표시를 클릭합니다. Dataplex Universal Catalog에 클러스터의 데이터베이스가 표시됩니다.

참고: 항목 목록 탭이 없으면 검색 페이지로 돌아가서 다른 클러스터를 선택하세요.
AlloyDB 데이터베이스 세부정보 페이지에서 항목 목록 탭을 클릭한 다음 검색에서 하위 항목 보기를 클릭합니다. Dataplex Universal Catalog에 클러스터의 테이블이 표시됩니다.
테이블 이름을 선택한 후 AlloyDB 테이블 세부정보 페이지에서 스키마를 클릭하여 테이블 열을 봅니다.
선택사항: 관점 유형을 열에 추가하려면 관점 추가 버튼을 클릭합니다.

가격 책정

Dataplex Universal Catalog에 AlloyDB 기술 메타데이터를 저장하는 데는 요금이 청구되지 않습니다. 표준 Dataplex Universal Catalog 가격 책정은 API 호출 및 추가 비즈니스 메타데이터 보강에 적용됩니다. 자세한 내용은 Dataplex Universal Catalog 가격 책정 페이지를 참조하세요.

리소스 사용량

Dataplex Universal Catalog는 클러스터에서 데이터를 주기적으로 추출합니다. 추출 프로세스를 수행하려면 일정량의 CPU를 사용해야 합니다. 더 작은 머신 유형(예: 큰 스키마(테이블 10,000개 이상)를 공유하는 머신)이 있는 클러스터에서는 추출 프로세스 중에 CPU양을 적게 사용할 수 있습니다.

제한사항

테이블은 데이터베이스당 최대 100만 개까지 허용됩니다.
데이터베이스 업데이트가 Dataplex Universal Catalog에 반영되는 데 최대 48시간이 걸릴 수 있습니다.
추출 프로세스는 일반적으로 몇 분 정도 걸리지만 CPU 크기와 테이블 수에 따라 완료 시간이 달라집니다.
인스턴스가 없거나 실행되고 있지 않으면 메타데이터가 삭제되는 데 7일이 걸릴 수 있습니다.

Dataplex Universal Catalog를 사용하여 AlloyDB 리소스 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

메타데이터 탐색 유형

키워드 및 자연어 검색

예: AlloyDB 데이터베이스 스키마 탐색

관점을 사용하여 메타데이터 보강

메타데이터 탐색 워크플로

시작하기 전에

필요한 IAM 역할

검색 결과에 액세스하는 데 필요한 역할

항목 검색에 필요한 역할

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 사용 설정

클러스터를 만들 때 Dataplex Universal Catalog 통합 사용 설정

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

AlloyDB 클러스터에 Dataplex Universal Catalog 통합 사용 설정

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 확인

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

AlloyDB 클러스터에서 Dataplex Universal Catalog 통합 비활성화

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

관점을 통해 AlloyDB 애셋 보강

AlloyDB 애셋 검색

쿼리를 사용하여 키워드 검색 수행

관점 유형별로 검색

AlloyDB에서 자연어 검색

AlloyDB에서 구문 검색

워크플로 예시 - 클러스터에서 열로 드릴다운

가격 책정

리소스 사용량

제한사항

다음 단계

Dataplex Universal Catalog를 사용하여 AlloyDB 리소스 관리