Dataplex 카탈로그를 사용하여 Cloud SQL 리소스 관리

MySQL | PostgreSQL | SQL Server

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

Dataplex 카탈로그는 메타데이터를 저장, 관리, 액세스할 수 있는 플랫폼입니다. Cloud SQL 인스턴스에 Dataplex 카탈로그 통합을 사용 설정하면 Dataplex 카탈로그는 Cloud SQL 인스턴스, 데이터베이스, 테이블, 열, 뷰에서 다음 메타데이터를 자동으로 검색합니다.

이름
위치(리전)
만든 날짜 및 마지막으로 수정한 날짜
스키마(테이블 및 뷰용)
설명

Dataplex 카탈로그는 읽기 복제본이 아닌 Cloud SQL 기본 인스턴스에서만 메타데이터를 검색합니다.

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

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

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

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

  pii:true
  pii_type:SSN

Dataplex 카탈로그에 대한 자세한 내용은 Dataplex 카탈로그 개요를 참조하세요.

시작하기 전에

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.

Go to project selector

Make sure 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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Dataplex API 사용 설정
권한 확인.

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

Dataplex 카탈로그 필수 IAM 역할 및 권한

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

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

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

Cloud SQL 인스턴스에서 Dataplex 카탈로그 통합 사용 설정

Cloud SQL 인스턴스에서 Dataplex 카탈로그 통합을 사용 설정하려면 다음 절차 중 하나를 사용합니다.

gcloud

인스턴스 만들기

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

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

다음을 바꿉니다.

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

인스턴스 업데이트

기존 인스턴스에 통합을 사용 설정하려면 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.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
  }
}

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

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 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"
}

인스턴스 업데이트

이 예시를 사용하여 기존 인스턴스를 업데이트합니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 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
  }
}

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

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 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.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
  }
}

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

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

다음과 비슷한 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"
}

인스턴스 업데이트

이 예시를 사용하여 기존 인스턴스를 업데이트합니다. 이 호출에 사용할 수 있는 매개변수의 전체 목록은 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
  }
}

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

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 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 인스턴스에서 Dataplex 카탈로그 통합 확인

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

gcloud

기존 인스턴스에서 Dataplex 카탈로그 통합이 사용 설정되어 있는지 확인하려면 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

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

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

다음과 비슷한 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

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

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

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

Cloud SQL 인스턴스에서 Dataplex 카탈로그 통합 비활성화

Cloud SQL 인스턴스에서 Dataplex 카탈로그 통합을 비활성화하려면 다음 절차 중 하나를 사용합니다.

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
  }
}

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

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 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
  }
}

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

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

다음과 비슷한 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 애셋 보강

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

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

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

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

Cloud SQL 애셋 검색

Google Cloud 콘솔의 Dataplex 카탈로그 검색 페이지를 사용하여 Cloud SQL 애셋을 검색합니다.

Dataplex 카탈로그 검색 페이지로 이동합니다.

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

쿼리를 사용하여 검색 수행

또한 Dataplex 카탈로그의 검색창을 사용하여 검색어를 수행할 수 있습니다. 모든 Cloud SQL 애셋을 보려면 system=Cloud_SQL을 입력합니다.

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

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL AND type=Table

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

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

type="projects/PROJECT_ID/locations/global/entryTypes/QUERY_STRING"

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 ID

QUERY_STRING: 다음 표를 사용하여 Cloud SQL 엔진 및 쿼리할 애셋 유형에 따라 쿼리 문자열을 식별

Cloud SQL 엔진	쿼리 문자열
MySQL용 Cloud SQL	`cloudsql-mysql-database` `cloudsql-mysql-instance` `cloudsql-mysql-table` `cloudsql-mysql-view` 참고: MySQL에는 스키마가 지원되지 않습니다.
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/1234567890/locations/global/entryTypes/cloudsql-postgresql-instance"

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

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

관점 패널에서 관점 유형 추가 메뉴를 클릭합니다.
SQL 액세스를 선택합니다.
확인을 클릭합니다.
playlist_add 수정 관점 버튼을 클릭합니다. SQL 액세스 페이지에서 다음을 수행합니다.
- 언어 필드에서 PostgreSQL을 선택하여 PostgreSQL용 Cloud SQL 애셋을 필터링합니다.
선택사항. 버전 필드를 선택하고 특정 버전의 PostgreSQL용 Cloud SQL을 입력합니다.
적용을 클릭합니다. Dataplex 카탈로그에는 PostgreSQL용 Cloud SQL 애셋만 표시됩니다.

관점 유형별로 검색

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

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

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

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

Dataplex 카탈로그 검색 페이지로 이동합니다.

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

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

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

가격 책정

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

리소스 사용량

Dataplex 카탈로그는 인스턴스에서 데이터를 주기적으로 추출합니다. 추출 프로세스에는 일정량의 CPU 사용량이 필요합니다. 더 작은 머신 유형(예: 공유 코어와 큰 스키마(테이블 10,000개 이상)가 있는 머신)이 있는 인스턴스는 추출 프로세스 중에 CPU를 최대 40%까지 사용할 수 있습니다.

제한사항

이 섹션에는 Cloud SQL 및 Dataplex 카탈로그 사용과 관련된 제한사항이 나와 있습니다.

Cloud SQL과 Dataplex 카탈로그 통합은 Assured Workloads에 리소스 등록으로 인해 리소스에 대한 액세스를 제한하는 모든 인스턴스에서 중지됩니다.
인스턴스에서 Dataplex 카탈로그를 사용 설정하면 머신 크기, 버전, 사용 중인 Cloud SQL 엔진 유형에 따라 Cloud SQL 리소스가 Dataplex 카탈로그에 애셋으로 표시되는 데 2~48시간 정도 걸릴 수 있습니다.

PostgreSQL용 Cloud SQL 및 Dataplex 카탈로그에는 알려진 제한사항이 없습니다.