Knowledge Catalog를 사용하여 AlloyDB 리소스 관리

Knowledge Catalog 통합은 모든 새 AlloyDB 클러스터에 기본적으로 사용 설정되어 있으므로 메타데이터를 저장, 관리, 액세스할 수 있는 플랫폼인 Knowledge Catalog를 사용하여 PostgreSQL용 AlloyDB 리소스를 검색하고 관리할 수 있습니다. 이 통합을 통해 AlloyDB 메타데이터를 검색하고 이해할 수 있으며, 다음 사용 사례를 지원합니다.

분석: 종속 항목을 이해하고 다양한 사용 사례에 대한 적합성을 평가합니다.
변경 관리: 메타데이터 변경사항을 효과적으로 추적하고 관리합니다.
스키마 개선: 스키마 수정사항을 모니터링하고 계획합니다.

Knowledge Catalog는 AlloyDB 클러스터, 인스턴스, 데이터베이스, 테이블, 열, 뷰에서 다음 메타데이터를 자동으로 검색합니다.

이름
위치 (지역)
라벨 (클러스터 및 인스턴스)
Dataplex 통합 사용 설정 (클러스터의 경우)
데이터베이스 버전
머신 CPU 수 (인스턴스용)
가용성 유형 (인스턴스용)
문자 집합 (데이터베이스용)
콜레이션 (데이터베이스용)
소유자
설명 (테이블, 뷰, 열, 외래 키용)
유형 (클러스터, 인스턴스, 머신)
열
- 데이터 유형
- 모드
기본 키
외래 키
- 참조된 표
- 열 매핑
생성 시간
최종 수정 시간

메타데이터 탐색 유형

Knowledge Catalog 메타데이터 검색은 연결된 데이터 소스(예: AlloyDB)를 스캔하여 테이블, 뷰, 데이터베이스와 같은 데이터 애셋을 식별하는 자동화된 프로세스입니다. 그런 다음 Knowledge Catalog는 스키마, 설명, 위치와 같은 애셋에서 기술 메타데이터를 Knowledge Catalog로 추출합니다.

이 프로세스는 메타데이터를 거의 실시간으로 동기화하여 카탈로그가 소스 시스템과 동기화된 상태로 유지되도록 합니다. AlloyDB의 경우 클러스터 및 인스턴스 메타데이터가 기본적으로 탐색됩니다. 새 클러스터에서는 데이터베이스, 스키마, 테이블, 뷰 메타데이터 검색이 기본적으로 사용 설정됩니다. 이 기본값이 구현되기 전 (2026년 2월 26일)에 생성된 클러스터의 경우 수동으로 통합을 사용 설정하세요.

키워드 및 자연어 검색

Knowledge Catalog는 키워드 검색과 자연어 검색을 지원합니다.

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

자세한 내용은 Knowledge Catalog 검색 구문을 참고하세요.

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

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

AlloyDB는 Knowledge Catalog에 거의 실시간으로 동기화되므로 다음 리소스를 사용할 수 있습니다.

클러스터
열
데이터베이스
인스턴스
테이블
조회수

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

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

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

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

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

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

메타데이터 탐색 워크플로

기본적으로 클러스터와 인스턴스 리소스를 수집하여 탐색할 수 있습니다. 데이터베이스, 스키마, 테이블, 뷰 리소스를 수집하고 검색하려면 다음 단계를 따르세요.

아직 사용 설정되지 않은 경우 AlloyDB API를 사용하여 AlloyDB 클러스터에 Knowledge Catalog 통합을 사용 설정합니다. 2026년 2월 26일 전에 생성된 클러스터에 필요합니다.
Google Cloud 콘솔의 Knowledge Catalog 검색 페이지를 사용하여 AlloyDB 애셋을 검색합니다. 자세한 내용은 Knowledge Catalog에서 리소스 검색을 참고하세요.
AlloyDB 애셋에 컨텍스트를 추가하려면 애셋에 관점을 연결하면 됩니다. 관점은 데이터 거버넌스 및 분석에 도움이 되는 커스텀 메타데이터 항목입니다. 예를 들어 관점을 사용하여 개인 식별 정보 (PII)가 포함된 열에 라벨을 지정할 수 있습니다. 자세한 내용은 관점 관리 및 메타데이터 보강을 참조하세요.
클러스터 > 데이터베이스 > 스키마 > 테이블 또는 뷰 > 열이라는 계층 구조에 따라 AlloyDB 리소스를 탐색합니다. 이 계층 구조는 데이터 환경을 자세히 보여줍니다. 자세한 내용은 Knowledge Catalog에서 리소스 검색을 참고하세요.

시작하기 전에

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

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) 역할과 권한이 있어야 합니다. 자세한 내용은 Knowledge Catalog 필수 IAM 역할 및 권한을 참고하세요.

필요한 IAM 역할

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

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

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

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

Knowledge 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)

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

Knowledge Catalog 통합 데이터 업데이트 빈도

기본적으로 Knowledge Catalog는 클러스터 및 인스턴스 리소스를 수집하고 검색하며 메타데이터 업데이트 빈도는 거의 실시간입니다.

새 AlloyDB 클러스터를 만들면 데이터베이스, 스키마, 테이블, 뷰 리소스의 Knowledge Catalog 통합이 기본적으로 사용 설정됩니다. 이 메타데이터가 동기화되지 않도록 하려면 통합을 사용 중지하세요.

통합을 사용 설정하면 주기적 동기화를 위해 데이터베이스, 스키마, 테이블과 같은 AlloyDB 메타데이터가 Cloud Storage 버킷으로 내보내지거나 거의 실시간 동기화를 위해 Pub/Sub 주제로 내보내져 Knowledge Catalog에서 사용할 수 있게 됩니다. 이 기능은 기본 클러스터에만 적용됩니다. 리전 간 복제에 사용되는 보조 클러스터는 데이터베이스, 스키마, 테이블, 뷰 메타데이터에 대한 Knowledge Catalog 통합을 지원하지 않습니다.

이러한 리소스의 메타데이터 업데이트 빈도는 클러스터가 생성되거나 복원된 시점에 따라 달라집니다.

거의 실시간: 2026년 4월 3일 이후에 생성되거나 복원된 클러스터는 메타데이터를 거의 실시간으로 Knowledge Catalog에 동기화합니다. 업데이트는 최대 5분 이내에 지식 카탈로그에서 확인할 수 있습니다. 추출 프로세스는 일반적으로 몇 초 정도 걸립니다.
몇 시간마다: 2026년 2월 26일과 2026년 4월 3일 사이에 생성되거나 복원된 클러스터는 몇 시간마다 Knowledge Catalog의 메타데이터를 새로고침합니다. 업데이트는 최대 48시간 이내에 Knowledge Catalog에서 확인할 수 있습니다. 추출 프로세스는 일반적으로 몇 분 정도 걸리지만 CPU 크기와 테이블 수에 따라 완료 시간이 달라집니다.

Knowledge Catalog 통합이 사용 중지된 AlloyDB 만들기

Google Cloud CLI 또는 AlloyDB API를 사용하여 클러스터를 만들거나 업데이트할 때 이 통합을 제어할 수 있습니다.

gcloud

gcloud alloydb clusters create 명령어를 사용하여 AlloyDB 클러스터를 만듭니다. --enable-dataplex-integration 플래그를 생략하면 데이터베이스, 스키마, 테이블, 뷰 메타데이터에 대해 Knowledge Catalog 통합이 기본적으로 사용 설정됩니다. 이 호출의 전체 파라미터 목록은 gcloud alloydb clusters create를 참고하세요. 클러스터 설정에 대한 자세한 내용은 클러스터 및 인스턴스 설정 보기를 참고하세요.

클러스터 ID는 시스템 로그, 모니터링 대시보드, 지원 커뮤니케이션과 같은 다양한 운영 컨텍스트에 표시될 수 있으므로 클러스터 ID에 민감한 정보나 개인 식별 정보를 포함하지 마세요. 클러스터 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 시스템에서 자동으로 포함합니다(예: 로그 파일에서).

데이터베이스, 스키마, 테이블, 뷰 리소스의 Knowledge Catalog 통합을 사용 중지하려면 --no-enable-dataplex-integration 플래그를 포함합니다.

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

다음을 바꿉니다.

CLUSTER_ID: 생성된 클러스터의 ID. 클러스터 ID는 소문자로 시작해야 하며 소문자, 숫자, 하이픈을 포함할 수 있습니다.
PASSWORD: 기본 postgres 사용자에게 사용하는 비밀번호
REGION: 클러스터가 위치한 리전의 ID입니다.

REST

POST 메서드를 사용하여 AlloyDB 클러스터를 만듭니다. 요청에서 dataplexConfig를 생략하면 데이터베이스, 스키마, 테이블, 뷰 메타데이터에 대해 Knowledge Catalog 통합이 기본적으로 사용 설정됩니다. 이 호출의 전체 파라미터 목록은 메서드: projects.locations.clusters.create를 참고하세요. 클러스터 설정에 대한 자세한 내용은 클러스터 및 인스턴스 설정 보기를 참고하세요.

데이터베이스, 스키마, 테이블, 뷰 리소스의 Knowledge Catalog 통합을 사용 중지하려면 요청 본문에 "dataplexConfig": { "enabled": false }을 포함하세요.

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

다음을 바꿉니다.

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 클러스터에 Knowledge Catalog 통합 사용 설정

기존 클러스터에서 Knowledge Catalog 통합을 사용 설정하려면 다음 절차 중 하나를 사용하세요.

gcloud

기존 클러스터에서 Knowledge Catalog 통합을 사용 설정하려면 --enable-dataplex-integration 플래그와 함께 gcloud alloydb clusters update 명령어를 사용합니다.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

다음을 바꿉니다.

CLUSTER_ID: 클러스터의 이름입니다.
REGION: 클러스터가 위치한 리전의 ID입니다.

REST

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

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

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
LOCATION_ID: 클러스터가 위치한 리전의 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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| 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 클러스터에서 Knowledge Catalog 통합 확인

기존 클러스터에서 Knowledge Catalog 통합이 사용 설정되어 있는지 확인하려면 다음 절차 중 하나를 사용합니다.

gcloud

기존 클러스터에서 Knowledge Catalog 통합이 사용 설정되어 있는지 확인하려면 gcloud alloydb clusters describe 명령어를 사용합니다.

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

다음을 바꿉니다.

CLUSTER_ID: 클러스터 ID입니다.
REGION: 클러스터가 위치한 리전의 ID입니다.

출력에는 YAML 형식의 dataplexConfig 섹션이 포함됩니다. enabled이 true이면 Knowledge Catalog 통합이 사용 설정됩니다.

dataplexConfig:
  enabled: true

REST

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

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

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

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
LOCATION_ID: 클러스터가 위치한 리전의 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/locations/LOCATION_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/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

dataplexConfig 메시지가 포함된 전체 클러스터 proto에 대한 JSON 응답이 표시됩니다.

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

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

AlloyDB 클러스터에서 Knowledge Catalog 통합을 사용 중지하면 클러스터 및 인스턴스 메타데이터만 사용할 수 있습니다.

gcloud

--no-enable-dataplex-integration 플래그가 지정된 gcloud alloydb clusters update 명령어를 사용하여 통합을 비활성화합니다.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

다음을 바꿉니다.

CLUSTER_ID: 클러스터의 ID입니다.
REGION: 클러스터가 위치한 리전의 ID입니다.

REST

다음 예시를 사용하여 통합을 비활성화합니다.

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

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

다음을 바꿉니다.

PROJECT_ID: 클러스터가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
LOCATION_ID: 클러스터가 위치한 리전의 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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| 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 콘솔의 Knowledge Catalog 검색 페이지를 사용하여 AlloyDB 애셋을 검색합니다.

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

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

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

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

자세한 내용은 Knowledge Catalog 검색 구문을 참고하세요.

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

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

system=AlloyDB AND type=Database

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

system=AlloyDB AND type=Table

또한 복잡한 표현식에 괄호 및 논리 연산자 AND와 OR을 사용할 수도 있습니다. 검색 필드에서 사용할 수 있는 표현식에 대한 자세한 내용은 Knowledge 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"

관점 유형별로 검색

Knowledge Catalog에는 검색을 수행하는 데 도움이 되는 몇 가지 기본 제공 관점 유형이 포함되어 있습니다.

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

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

AlloyDB에서 자연어 검색

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

자세한 내용은 Knowledge Catalog 검색 구문을 참고하세요.

AlloyDB에서 구문 검색

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

자세한 내용은 Knowledge Catalog 검색 구문을 참고하세요.

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

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

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

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

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

가격 책정

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

리소스 사용

Knowledge Catalog는 AlloyDB 클러스터에서 메타데이터를 주기적으로 추출합니다. 이 추출 프로세스는 클러스터의 CPU 리소스를 사용합니다. CPU 사용량은 일반적으로 최소화됩니다. 예를 들어 큰 스키마 (테이블 100,000개 이상)를 관리하는 더 작은 머신 유형 (예: n2-highmem-2-icelake)이 있는 클러스터의 경우 추출 중에 CPU 사용량이 최대 5% 까지 증가할 수 있습니다.

제한사항

통합은 데이터베이스당 최대 100만 개의 테이블과 테이블당 평균 150개의 열을 지원합니다. 이러한 한도 중 하나를 초과하면 데이터베이스, 스키마, 테이블, 뷰와 같은 리소스의 메타데이터가 추출되지 않습니다. Knowledge Catalog에서는 클러스터 및 인스턴스 메타데이터만 사용할 수 있습니다.
클러스터를 처음 만들 때 모든 메타데이터를 Knowledge Catalog에 초기 동기화하는 데 최대 48시간이 걸릴 수 있습니다. 초기 동기화 후에는 후속 업데이트를 거의 실시간으로 사용할 수 있습니다.
데이터베이스에서 메타데이터 변경률이 높은 경우 (초당 100개 이상의 DDL 변경사항) Knowledge Catalog와의 거의 실시간 메타데이터 동기화가 최대 30분 동안 일시중지된 후 다시 시작될 수 있습니다.
메타데이터 변경률이 높거나, 네트워킹 문제가 있거나, 동기화 프로세스가 중단되어 업데이트가 누락되는 경우에도 48시간 이내에 Knowledge Catalog에 표시됩니다.
인스턴스가 없거나 실행되고 있지 않으면 메타데이터가 삭제되는 데 7일이 걸릴 수 있습니다.
데이터베이스의 이름이 변경되면 데이터베이스 업데이트만 실시간에 가깝게 Knowledge Catalog에서 사용할 수 있습니다. 데이터베이스와 모든 관련 테이블의 기본 매핑은 48시간 이내에 Knowledge Catalog에서 업데이트됩니다.

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

메타데이터 탐색 유형

키워드 및 자연어 검색

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

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

메타데이터 탐색 워크플로

시작하기 전에

필요한 IAM 역할

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

항목 검색에 필요한 역할

Knowledge Catalog 통합 데이터 업데이트 빈도

Knowledge Catalog 통합이 사용 중지된 AlloyDB 만들기

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

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

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

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

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

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

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

관점을 통해 AlloyDB 애셋 보강

AlloyDB 애셋 검색

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

관점 유형별로 검색

AlloyDB에서 자연어 검색

AlloyDB에서 구문 검색

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

가격 책정

리소스 사용

제한사항

다음 단계

Knowledge Catalog를 사용하여 AlloyDB 리소스 관리