데이터 도메인 사용

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '현재 상태 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

데이터 도메인 사용자는 데이터 도메인을 사용하여 검색 결과를 특정 비즈니스 컨텍스트로 좁히고, BigQuery 데이터 세트, 테이블, 데이터 제품을 검색하고, 특정 도메인 경계 내에서 메타데이터를 탐색할 수 있습니다.

시작하기 전에

도메인별로 검색을 수행하기 전에 필요한 역할과 API가 사용 설정되어 있는지 확인합니다.

API 사용 설정

Dataplex API 사용 설정

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한을 이미 보유하고 있을 가능성이 높습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기

API 사용 설정하기

필요한 역할

데이터 도메인을 사용하여 메타데이터를 검색하고 탐색하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트 또는 데이터 도메인에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• 탐색을 위한 도메인 항목의 메타데이터 보기: Dataplex 데이터 도메인 항목 리더 (roles/dataplex.dataDomainEntryReader)
• 도메인 구성 및 바인딩 보기: Dataplex 데이터 도메인 구성 뷰어 (roles/dataplex.dataDomainViewer)

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

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

도메인 계층 구조 둘러보기

도메인 계층 구조를 둘러보는 방법에 관한 자세한 내용은 위치에서 데이터 도메인 및 하위 도메인 보기를 참조하세요.

데이터 도메인 내에서 리소스 찾기

도메인으로 리소스를 검색하려면 다음 단계를 따르세요.

콘솔

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

   검색으로 이동

2. 자연어 검색 사용해 보기 를 클릭하여 자연어 검색 기능을 활성화합니다.

3. 필터 를 클릭합니다.

4. 범위 필드의 목록에서 도메인 을 선택합니다.

5. 도메인 선택 필드에서 결과를 좁힐 도메인을 선택합니다. 필요한 경우 추가 필터를 추가합니다.

또는 도메인 내 검색 메뉴 옵션을 사용하여 도메인에서 리소스를 찾을 수 있습니다.

1. Google Cloud 콘솔에서 데이터 도메인 페이지로 이동합니다.

   데이터 도메인으로 이동

2. more_vert 메뉴에서 도메인 내 검색 을 선택합니다. 그러면 도메인 필터가 적용된 검색 창이 자동으로 열립니다.

3. 검색 필드를 사용하여 도메인에서 리소스를 찾습니다.

REST

데이터 도메인으로 범위가 지정된 항목을 검색하려면 projects.locations.searchEntries 메서드를 사용하고 contexts 매개변수에 도메인 경로를 제공합니다.

참고: searchEntries의 경로에 있는 위치는 검색 백엔드 구성에 따라 global (전체 팬아웃) 또는 특정 리전일 수 있습니다.

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

• PROJECT_ID: 프로젝트 Google Cloud 의 ID입니다.
• LOCATION_ID: 검색 문의의 리전 (global)입니다.
• QUERY: 쿼리 문자열입니다.
• DOMAIN_ID: 검색 범위 컨텍스트를 정의하는 데이터 도메인의 고유 식별자입니다.

HTTP 메서드 및 URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

JSON 요청 본문:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

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

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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

성공 상태 코드 (2xx)와 빈 응답을 받게 됩니다.

제한사항

전역 검색을 사용하는 경우와 같이 도메인 컨텍스트 외부에서 리소스를 검색하면 도메인의 탐색 가능성 권한이 적용되지 않습니다. BigQuery와 같은 기본 시스템에서 액세스할 수 있는 리소스만 표시됩니다.

BigQuery 데이터 세트가 데이터 도메인에 포함되어 있다고 가정해 보겠습니다. 도메인에 대한 Dataplex Data Domain Entry Reader 역할이 있지만 BigQuery에서 데이터 세트를 볼 수 있는 직접적인 권한은 없습니다.

• 도메인 내 검색: 도메인 권한이 적용되므로 검색 결과에 데이터 세트가 표시됩니다.
• 도메인 외부 검색: 검색 결과에 데이터 세트가 표시되지 않습니다. 일반 검색에서는 도메인 권한이 적용되지 않으며 BigQuery에서 직접 액세스할 수 없습니다.

다음 단계

• 데이터 도메인에 대해 자세히 알아보기
• 데이터 도메인을 만드는 방법 알아보기.
• 데이터 도메인 리소스를 관리하는 방법 알아보기.