Knowledge Catalog를 사용하여 Cloud SQL 리소스 관리

이 페이지에서는 Knowledge Catalog를 사용하여 Cloud SQL 리소스를 검색하고 관리하는 방법을 설명합니다.

Knowledge Catalog는 메타데이터를 저장, 관리, 액세스할 수 있는 플랫폼입니다. Knowledge Catalog는 Cloud SQL 인스턴스, 데이터베이스, 테이블, 열, 뷰에서 다음 메타데이터를 자동으로 검색합니다.

  • 이름
  • 위치(리전)
  • 만든 날짜 및 마지막으로 수정한 날짜
  • 스키마(테이블 및 뷰용)
  • 설명
  • 기본 키 및 외래 키 제약 조건

Knowledge Catalog는 읽기 복제본 또는 외부 서버 복제본이 아닌 Cloud SQL 기본 인스턴스에서만 메타데이터를 검색합니다.

Knowledge Catalog를 사용하여 Cloud SQL 메타데이터를 탐색하고 파악할 수 있습니다. Knowledge Catalog를 사용하면 다음 활동을 지원할 수 있습니다.

  • 데이터 검색
  • 분류
  • 사용 사례의 종속 항목과 적합성 등의 분석
  • 변경 관리
  • 데이터 이동(파이프라인)
  • 스키마 개선

Knowledge Catalog를 사용하면 Cloud SQL 메타데이터 항목에 관점을 연결하여 메타데이터를 선별할 수 있습니다. 각 관점은 여러 메타데이터 필드를 가질 수 있으며 사전 정의된 또는 커스텀 관점 유형을 기반으로 할 수 있습니다.

예를 들어 개인 식별 정보(PII)인 주민등록번호가 포함된 열에 다음과 같은 관점을 연결할 수 있습니다.

  pii:true
  pii_type:SSN

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

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

Knowledge Catalog의 인스턴스 메타데이터의 예상 최신 상태는 인스턴스의 생성 날짜와 데이터베이스 버전에 따라 다릅니다.

거의 실시간

인스턴스가 다음 기준을 모두 충족하는 경우 인스턴스를 만들 때 Knowledge Catalog와의 통합이 기본적으로 사용 설정됩니다.

  1. 생성 시간: 2026년 4월 18일 이후

  2. 버전: PostgreSQL용 Cloud SQL 버전 14.0 이상
  3. 네트워크 아키텍처: 새 네트워크 아키텍처

인스턴스가 이러한 기준을 모두 충족하지 않으면 하루에 한 번을 참고하세요.

이러한 기준을 모두 충족하는 인스턴스는 애셋의 생성 및 업데이트 시간을 추적하는 타임스탬프 테이블을 포함하여 생성됩니다. 타임스탬프 테이블은 cloudsqladmin 데이터베이스에 있습니다. 인스턴스에 DDL 또는 스키마 변경사항이 있으면 통합에서 타임스탬프 테이블을 쿼리하여 최근에 변경된 애셋을 식별한 다음 최신 스키마 업데이트를 거의 실시간으로 Knowledge Catalog에 로드합니다. 드물지만 네트워크 불안정 등의 경우 Knowledge Catalog에서 업데이트를 누락할 수 있습니다. 드물지만 누락된 변경사항은 결국 일관성을 갖게 되며 일반적으로 24시간 이내에 일관성을 갖게 됩니다. 변경사항이 누락될 수 있는 시나리오에 관한 자세한 내용은 이 페이지의 제한사항을 참고하세요.

인스턴스에서 실행된 쿼리를 보면 Knowledge Catalog 통합을 지원하는 쿼리가 표시됩니다. 이러한 쿼리는 포함된 --Dataplex 주석으로 식별할 수 있습니다. 인스턴스의 쿼리를 보려면 활성 쿼리 보기를 참고하세요.

통합을 비활성화하고 인스턴스 업데이트의 안내에 따라 나중에 다시 사용 설정할 수 있습니다.

1일 1회

다음 기준 중 하나라도 충족하는 인스턴스에 Knowledge Catalog와의 통합을 사용 설정할 수 있습니다.

  1. 생성 시간: 2026년 4월 18일 이전
  2. 버전: PostgreSQL용 Cloud SQL 버전 14.0 미만
  3. 네트워크 아키텍처: 이전 네트워크 아키텍처

2026년 4월 18일 이후에 인스턴스를 만든 경우 Knowledge Catalog와의 통합이 기본적으로 사용 설정됩니다. 2026년 4월 18일 이전에 생성된 인스턴스의 경우 기존 Cloud SQL 인스턴스에서 Knowledge Catalog 통합을 사용 설정 할 수 있습니다.

Knowledge Catalog와의 통합을 사용 설정하면 이러한 기준을 충족하는 인스턴스의 메타데이터가 일반적으로 하루에 한 번 정도 Knowledge Catalog에서 새로고침됩니다. 필요에 따라 Knowledge Catalog 통합을 비활성화하고 다시 사용 설정할 수 있습니다.

시작하기 전에

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

  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. Verify that billing is enabled for your Google Cloud project.

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

    Dataplex API 사용 설정

  7. 권한 확인.

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

Knowledge Catalog에 필요한 IAM 역할 및 권한

Cloud SQL은 cloudsql.schemas.view 권한을 사용하여 Knowledge Catalog의 메타데이터에 대한 액세스 권한을 제공합니다.

이 권한을 제공하려면 이 권한이 포함된 커스텀 역할을 만들거나 이 권한이 있는 사전 정의된 역할 중 하나를 사용합니다.

자세한 내용은 사전 정의된 Cloud SQL IAM 역할을 참조하세요.

Knowledge Catalog 통합이 사용 설정된 인스턴스 만들기

새 인스턴스는 기본적으로 Knowledge Catalog와 통합됩니다. Knowledge Catalog 통합이 사용 설정된 새 인스턴스를 만들려면 새 인스턴스를 만들기만 하면 됩니다. 거의 실시간으로 Knowledge Catalog가 통합된 인스턴스를 만들려면 새 인스턴스가 다음 기준을 모두 충족해야 합니다.

  1. 생성 시간: 2026년 4월 18일 이후

  2. 버전: PostgreSQL용 Cloud SQL 버전 14.0 이상
  3. 네트워크 아키텍처: 새 네트워크 아키텍처

이전 데이터베이스 버전 또는 기존 네트워크 아키텍처를 사용하는 새 인스턴스에 거의 실시간 지식 카탈로그를 사용 설정하려면 인스턴스를 클론하거나 백업에서 새 인스턴스로 복원하면 됩니다.

gcloud

인스턴스 만들기

Cloud SQL 인스턴스를 만들려면 gcloud sql instances create 명령어를 사용합니다.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

다음을 바꿉니다.

  • INSTANCE_NAME: 인스턴스 이름입니다.
  • DATABASE_VERSION: 인스턴스의 데이터베이스 버전 (예: POSTGRES_14). 사용 가능한 문자열의 전체 목록은 SqlDatabaseVersion을 참고하세요.
  • MACHINE_TYPE: 인스턴스의 머신 유형
  • REGION_NAME: 인스턴스의 리전 이름

이 예시는 Linux 기반입니다.

REST v1

인스턴스 만들기

이 예시를 사용하여 통합이 사용 설정된 인스턴스를 만듭니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 instances.insert 페이지를 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름
  • REGION_NAME: 인스턴스의 리전 이름
  • DATABASE_VERSION: 데이터베이스 버전의 열거형 문자열(예: POSTGRES_13). 사용 가능한 문자열의 전체 목록은 SqlDatabaseVersion을 참조하세요.
  • PASSWORD: root 사용자의 비밀번호
  • MACHINE_TYPE: db-custom-[CPUS]-[MEMORY_MBS]와 같은 머신(등급) 유형의 열거형 문자열.
  • EDITION_TYPE: Cloud SQL 버전

HTTP 메서드 및 URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

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

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

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

REST v1beta4

인스턴스 만들기

이 예시를 사용하여 통합이 사용 설정된 인스턴스를 만듭니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 instances.insert 페이지를 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름
  • REGION_NAME: 인스턴스의 리전 이름
  • DATABASE_VERSION: 데이터베이스 버전의 열거형 문자열(예: POSTGRES_13). 사용 가능한 문자열의 전체 목록은 SqlDatabaseVersion을 참조하세요.
  • PASSWORD: root 사용자의 비밀번호
  • MACHINE_TYPE: db-custom-[CPUS]-[MEMORY_MBS]와 같은 머신(등급) 유형의 열거형 문자열.
  • EDITION_TYPE: Cloud SQL 버전

HTTP 메서드 및 URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 요청 본문:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

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

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

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

기존 Cloud SQL 인스턴스에서 Knowledge Catalog 통합 사용 설정

이 섹션은 다음 기준 중 하나라도 충족하는 인스턴스에 적용됩니다.
  1. 생성 시간: 2026년 4월 18일 이전
  2. 버전: PostgreSQL용 Cloud SQL 버전 14.0 미만
  3. 네트워크 아키텍처: 이전 네트워크 아키텍처

이 섹션의 업데이트 안내에 따라 이전에 거의 실시간으로 Knowledge Catalog와 통합된 인스턴스에서 Knowledge Catalog 통합을 다시 사용 설정할 수도 있습니다. 통합을 다시 사용 설정한 후 거의 실시간 데이터가 Knowledge Catalog에 표시되기까지 최대 10분이 걸립니다.

기존 Cloud SQL 인스턴스에서 Knowledge Catalog 통합을 사용 설정하거나 다시 사용 설정하려면 다음 절차 중 하나를 사용합니다.

gcloud

인스턴스 업데이트

기존 인스턴스에 통합을 사용 설정하려면 gcloud sql instances patch 명령어를 사용합니다.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

프로젝트의 모든 Cloud SQL 인스턴스를 사용 설정하고 업데이트해야 하는 경우 다음과 유사한 스크립트를 실행하면 됩니다.

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

이 예시는 Linux 기반입니다.

REST v1

인스턴스 업데이트

이 예시를 사용하여 기존 인스턴스를 업데이트합니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 instances.patch 페이지를 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

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

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

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

REST v1beta4

인스턴스 업데이트

이 예시를 사용하여 기존 인스턴스를 업데이트합니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 instances.patch 페이지를 참조하세요.

이 예시를 사용하여 기존 인스턴스를 업데이트합니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 instances.patch 페이지를 참조하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

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

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

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

Cloud SQL 인스턴스에서 Knowledge Catalog 통합 확인

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

gcloud

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

gcloud sql instances describe INSTANCE_NAME

INSTANCE_NAME을 인스턴스 이름으로 바꿉니다. 출력에서 true로 설정된 구성 설정 enableDataplexIntegration을 찾습니다.

REST v1

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID
  • INSTANCE_ID: 인스턴스 ID

HTTP 메서드 및 URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

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

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

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

REST v1beta4

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 ID
  • INSTANCE_ID: 인스턴스 ID

HTTP 메서드 및 URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

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

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

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

Cloud SQL 인스턴스에서 Knowledge Catalog 통합 비활성화

Cloud SQL 인스턴스에서 Knowledge Catalog 통합을 비활성화하려면 다음 절차 중 하나를 사용합니다. 거의 실시간으로 통합된 인스턴스에서 Knowledge Catalog 통합을 사용 중지하는 데 최대 10분이 걸립니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. 수정을 클릭합니다.
  4. 인스턴스 맞춤설정 섹션에서 구성 옵션 표시 메뉴를 펼칩니다.

  5. 플래그 및 매개변수 섹션에서 Enable Knowledge Catalog integration(Knowledge Catalog 통합 사용 설정) 체크박스를 선택 취소합니다.

  6. 저장을 클릭합니다.

gcloud

기존 인스턴스 통합을 비활성화하려면 gcloud sql instances patch 명령어를 사용합니다.

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

통합을 비활성화하고 프로젝트의 모든 Cloud SQL 인스턴스를 업데이트해야 하는 경우 다음과 비슷한 스크립트를 실행하면 됩니다.

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

이 예시는 Linux 기반입니다.

REST v1

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

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

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

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

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

REST v1beta4

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

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
  • INSTANCE_NAME: 인스턴스 이름

HTTP 메서드 및 URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 요청 본문:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

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

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

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

관점을 통해 Cloud SQL 애셋 보강

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

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

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

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

Cloud SQL 애셋 검색

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

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

    검색 페이지로 이동

  2. 검색 플랫폼 선택에서 Knowledge Catalog를 선택합니다.

  3. 필터 패널에서 시스템을 클릭한 후 Cloud SQL을 선택합니다.

  4. 선택사항. 유형 별칭에서 다음 유형 별칭 중 하나 이상을 선택하여 특정 유형의 Cloud SQL 애셋으로 검색 결과를 필터링할 수 있습니다.

    • 데이터베이스
    • 데이터베이스 스키마
    • 서비스
    • 표
    • 보기

쿼리를 사용하여 검색 수행

Knowledge Catalog의 검색창을 사용하여 검색어를 수행할 수도 있습니다. 모든 Cloud SQL 애셋을 보려면 system=Cloud_SQL을 입력합니다.

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

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL AND type=Table

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

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

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

QUERY_STRING을 Cloud SQL 엔진 및 쿼리할 애셋 유형에 따른 쿼리 문자열로 바꿉니다. 다음 표를 사용하여 적절한 쿼리 문자열을 확인하세요.

Cloud SQL 엔진 쿼리 문자열
MySQL용 Cloud SQL
  • cloudsql-mysql-database
  • cloudsql-mysql-instance
  • cloudsql-mysql-table
  • cloudsql-mysql-view
PostgreSQL용 Cloud SQL
  • cloudsql-postgresql-database
  • cloudsql-postgresql-instance
  • cloudsql-postgresql-table
  • cloudsql-postgresql-schema
  • cloudsql-postgresql-view
SQL Server용 Cloud SQL
  • cloudsql-sqlserver-database
  • cloudsql-sqlserver-instance
  • cloudsql-sqlserver-table
  • cloudsql-sqlserver-schema
  • cloudsql-sqlserver-view

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

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

Cloud SQL 언어별로 Cloud SQL 애셋 필터링

기본적으로 Knowledge Catalog에는 모든 Cloud SQL 애셋이 표시됩니다. MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL 또는 SQL Server의 애셋만 필터링하려면 다음 단계를 수행합니다.

  1. 관점 패널에서 관점 유형 추가 메뉴를 클릭합니다.

  2. SQL 액세스를 선택합니다.

  3. 확인을 클릭합니다.

  4. playlist_add 수정 관점 버튼을 클릭합니다. SQL 액세스 페이지에서 다음을 수행합니다.

    • 언어 필드에서 PostgreSQL을 선택하여 PostgreSQL용 Cloud SQL 애셋을 필터링합니다.
  5. 선택사항. 버전 필드를 선택하고 특정 버전의 PostgreSQL용 Cloud SQL을 입력합니다.

  6. 적용을 클릭합니다. Knowledge Catalog에는 PostgreSQL용 Cloud SQL 애셋만 표시됩니다.

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

  1. 관점 패널에서 관점 유형 추가 메뉴를 클릭합니다.

  2. 선택사항. SQL 액세스를 선택하여 Cloud SQL 언어별로 결과를 필터링합니다. 자세한 내용은 이전 절차인 Cloud SQL 언어별로 Cloud SQL 애셋 필터링을 참조하세요.

  3. 다음 관점 유형 중에서 하나 이상을 선택하여 검색 결과를 해당 유형으로 제한합니다.

    • Cloud SQL 데이터베이스
    • Cloud SQL 인스턴스
    • Cloud SQL 뷰
    • Cloud SQL 스키마
    • Cloud SQL 테이블

  4. 확인을 클릭합니다.

  5. 결과 테이블에서 애셋 이름을 클릭하여 해당 애셋의 메타데이터를 봅니다.

  6. 선택사항: 애셋을 개선하거나 봅니다. 다음 중 원하는 방법을 사용할 수 있습니다.

    • 개요에서 추가를 클릭하여 애셋에 대한 서식 있는 텍스트 설명을 추가합니다.
    • 관점에서 추가를 클릭하여 관점을 애셋에 연결합니다.
    • 인스턴스의 경우 구성원 데이터베이스를 보려면 항목 목록 탭을 클릭한 후 검색에 하위 항목 모두 표시를 클릭합니다. 항목 목록 탭이 표시되지 않으면 인스턴스에 데이터베이스가 없는 것입니다.
    • 항목 세부정보에서 애셋의 전체 세부정보를 봅니다. 항목 이름을 클릭하여 추가 항목으로 드릴다운합니다.

워크플로 예시 - 인스턴스에서 열로 드릴다운

이 워크플로 예시에서는 순서대로 Cloud SQL 인스턴스를 검색하고 구성원 데이터베이스를 보고 해당 데이터베이스의 테이블을 본 다음 테이블의 열을 봅니다.

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

    검색 페이지로 이동

  2. 검색 플랫폼 선택 옵션에서 Knowledge Catalog를 선택합니다.

  3. 필터 패널에서 시스템을 선택한 후 Cloud SQL을 선택합니다. 또는 검색창에 system=Cloud_SQL을 입력합니다.

  4. 인스턴스 이름을 선택합니다.

  5. Cloud SQL 세부정보 페이지에서 항목 목록 탭을 클릭한 후 검색에 하위 항목 모두 표시를 클릭합니다. Knowledge Catalog에 인스턴스의 데이터베이스가 표시됩니다.

  6. Cloud SQL 데이터베이스 세부정보 페이지에서 항목 목록 탭을 클릭한 후 검색에서 하위 항목 보기를 클릭합니다. Knowledge Catalog에 데이터베이스의 테이블이 표시됩니다.

  7. 테이블 이름을 선택한 후 Cloud SQL 테이블 세부정보 페이지에서 스키마를 클릭하여 테이블 열을 봅니다.

  8. 선택사항: 관점 유형을 열에 추가하려면 관점 추가 버튼을 클릭합니다.

이 워크플로에서는 인스턴스에서 테이블로 드릴다운하는 방법을 보여줍니다. 검색창에 system=Cloud_SQL AND type=Table을 입력하여 테이블 목록으로 직접 이동할 수 있습니다.

가격 책정

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

리소스 사용

Knowledge Catalog 통합이 사용 설정된 동안 Knowledge Catalog는 인스턴스에서 데이터를 주기적으로 추출합니다. 추출 프로세스를 수행하려면 일정량의 CPU를 사용해야 합니다. 거의 실시간으로 Knowledge Catalog와 통합된 인스턴스와 2026년 4월 18일 이후에 생성된 기타 인스턴스는 일반적으로 CPU 사용량에 미치는 영향이 최소화됩니다. 2026년 3월 19일 이전에 생성된 모든 인스턴스를 비롯해 2026년 4월 18일 이전에 생성된 대부분의 인스턴스의 경우 CPU 사용량이 더 클 수 있습니다. 이는 특히 더 작은 머신 유형(예: 공유 코어와 큰 스키마(테이블 10,000개 이상)가 있는 머신)이 있는 인스턴스에서 두드러지며, 이러한 인스턴스는 추출 프로세스 중에 CPU를 최대 40% 까지 사용할 수 있습니다.

제한사항

이 섹션에는 Cloud SQL 및 Knowledge Catalog 사용과 관련된 제한사항이 나와 있습니다.

  • 2026년 4월 18일 이전에 생성된 인스턴스의 경우, Cloud SQL과의 Knowledge Catalog 통합은 Assured Workloads에 리소스 등록으로 인해 리소스에 대한 액세스를 제한하는 모든 인스턴스에서 중지됩니다.

  • 인스턴스에서 Knowledge Catalog를 사용 설정하면 머신 크기, 버전, 사용 중인 Cloud SQL 엔진 유형에 따라 Cloud SQL 리소스가 Knowledge Catalog에 애셋으로 표시되는 데 2~48시간 정도 걸릴 수 있습니다. 거의 실시간에 설명된 대로 인스턴스가 거의 실시간으로 업데이트되는 경우에는 이 제한사항이 적용되지 않습니다.

  • 고가용성 (HA)으로 구성된 인스턴스는 생성 시 Knowledge Catalog가 자동으로 사용 설정되지 않습니다. Knowledge Catalog가 이미 사용 설정된 인스턴스에 고가용성을 사용 설정하면 Knowledge Catalog를 사용 중지하지 않는 한 Knowledge Catalog가 사용 설정된 상태로 유지됩니다.

다음 제한사항은 거의 실시간에 설명된 대로 인스턴스가 거의 실시간으로 업데이트되는 경우에만 적용됩니다.

  • 데이터베이스의 이름이 변경되면 데이터베이스 업데이트만 실시간에 가깝게 Knowledge Catalog에서 사용할 수 있습니다. 데이터베이스와 모든 관련 테이블의 기본 매핑은 Knowledge Catalog에서 최종적으로 일관됩니다.
  • VPC 서비스 제어가 사용 설정된 인스턴스에서는 거의 실시간으로 Knowledge Catalog 통합이 지원되지 않습니다.
  • 인스턴스에서 메시지를 삭제할 수 있으며, 이로 인해 Knowledge Catalog의 데이터가 최종적으로만 일관성을 갖게 될 수 있습니다. 메시지가 삭제되면 누락된 업데이트가 결국 Knowledge Catalog에 표시됩니다. 인스턴스에서 메시지를 삭제할 수 있는 경우는 다음과 같습니다.
    • 짧은 시간 내에 DDL 비율이 높은 인스턴스
    • 기존 인스턴스의 클론인 인스턴스입니다.
    • 백업에서 복원된 인스턴스입니다.
    • 메모리가 부족한 인스턴스
    • 인스턴스가 다시 시작되거나 데이터베이스가 다시 시작되는 경우
    • 네트워크 문제가 있거나 Knowledge Catalog와의 동기화 프로세스가 중단된 인스턴스

다음 단계