데이터 교환 관리

미리보기

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

Analytics Hub 관리자는 다음 작업을 수행할 수 있습니다.

• 데이터 교환을 생성, 업데이트, 확인, 공유, 삭제합니다.
• 목록을 생성, 업데이트, 삭제, 공유
• Analytics Hub 관리자, 목록 관리자, 게시자, 구독자, 뷰어 관리

기본적으로 데이터 교환은 비공개이며 해당 교환에 대한 액세스 권한이 있는 사용자 또는 그룹만 데이터를 보거나 구독할 수 있습니다. 하지만 Google Cloud 사용자(allauthenticated 사용자)가 목록을 탐색하고 구독할 수 있도록 하려면 데이터 교환을 공개로 설정하도록 요청하면 됩니다.

시작하기 전에

Analytics Hub를 시작하려면 Google Cloud 프로젝트 내에서 Analytics Hub API를 사용 설정해야 합니다.

필수 권한

Analytics Hub API를 사용 설정하려면 다음 Identity and Access Management(IAM) 권한이 필요합니다.

• serviceUsage.services.get/list: Cloud 콘솔에서 API 보기
• serviceUsage.services.enable: API 사용 설정

다음과 같은 사전 정의된 IAM 역할에는 Analytics Hub API를 사용 설정하는 데 필요한 권한이 포함되어 있습니다.

• roles/editor
• roles/owner
• roles/serviceusage.serviceUsageAdmin

BigQuery에서 IAM 역할에 대한 상세 설명은 사전 정의된 역할 및 권한을 참조하세요.

Analytics Hub API 사용 설정

Analytics Hub API를 사용 설정하려면 다음 단계를 따르세요.

콘솔

Google Cloud 프로젝트의 Analytics Hub API로 이동하여 사용 설정합니다.

Analytics Hub API 사용 설정

gcloud

gcloud services enable 명령어를 실행합니다.

gcloud services enable analyticshub.googleapis.com

필수 권한

데이터 교환을 관리하려면 Analytics Hub 관리자 역할(roles/analyticshub.admin)이 있어야 합니다. 자세한 내용은 Analytics Hub 관리자 역할을 참조하세요. 다른 사용자에게 이 역할을 부여하는 방법을 알아보려면 Analytics Hub 관리자 만들기를 참조하세요.

데이터 교환 만들기

주의: VPC 서비스 제어 경계가 있는 프로젝트에는 데이터 교환을 만들지 않는 것이 좋습니다. 만드는 경우 적절한 인그레스 및 이그레스 규칙을 추가해야 합니다.

데이터 교환을 만들려면 다음 단계를 따르세요.

콘솔

1. Google Cloud Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. 교환 만들기를 클릭합니다.

3. 교환 만들기 대화상자에서 데이터 교환의 프로젝트 및 리전을 선택합니다. 데이터 교환을 만든 후에는 프로젝트 및 리전을 업데이트할 수 없습니다.

4. 표시 이름에 데이터 교환 이름을 입력합니다.

5. 선택사항: 다음 필드에 값을 입력합니다.

   • 기본 연락처: 데이터 교환용 기본 연락처의 URL 또는 이메일 주소를 입력합니다.
   • 설명: 데이터 교환에 대한 설명을 입력합니다.

6. 교환 만들기를 클릭합니다.

7. 선택사항: 교환 권한 섹션에서 다음 단계를 수행합니다.

   1. 다음 필드에 이메일 주소를 입력하여 Analytics Hub 사용자 역할을 부여합니다.

      • 관리자: 이러한 사용자에게는 Analytics Hub 관리자 역할이 할당됩니다.
      • 게시자: 이러한 사용자에게는 Analytics Hub 게시자 역할이 할당됩니다. 게시자가 수행할 수 있는 작업에 대한 자세한 내용은 목록 관리를 참조하세요.
      • 구독자: 이러한 사용자에게는 Analytics Hub 구독자 역할이 할당됩니다. 구독자가 수행할 수 있는 작업에 대한 자세한 내용은 목록 보기 및 구독을 참조하세요.
      • 뷰어: 이 사용자에게는 Analytics Hub 뷰어 역할이 할당됩니다. 뷰어는 목록을 볼 수 있습니다.

   2. 권한을 저장하려면 권한 설정을 클릭합니다.

8. 데이터 교환에 대한 권한을 설정하지 않은 경우 건너뛰기를 클릭합니다.

API

projects.locations.dataExchanges.create 메서드를 사용합니다.

POST https://analyticshub.googleapis.com/v1beta1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

다음을 바꿉니다.

• PROJECT_ID: 데이터 교환을 만들려는 프로젝트의 ID
• LOCATION: 데이터 교환 위치. Analytics Hub를 지원하는 위치에 대한 자세한 내용은 지원되는 리전을 참조하세요.
• DATAEXCHANGE_ID: 데이터 교환의 ID

요청 본문에 데이터 교환 세부정보를 제공합니다. 요청이 성공하면 응답 본문에 데이터 교환의 세부정보가 포함됩니다.

API를 사용하여 데이터 교환에서 수행할 수 있는 작업에 대한 자세한 내용은 projects.locations.dataExchanges 메서드를 참조하세요.

데이터 교환 업데이트

데이터 교환을 업데이트하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. 데이터 교환 목록에서 업데이트할 데이터 교환을 클릭합니다.

3. 교환 수정을 클릭합니다.

4. 교환 수정 대화상자에서 다음 필드를 업데이트합니다.

   • 표시 이름
   • 기본 연락처
   • 설명

5. 저장을 클릭합니다.

API

projects.locations.dataExchanges.patch 메서드를 사용합니다.

PATCH https://analyticshub.googleapis.com/v1beta1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

UPDATEMASK를 업데이트할 필드 목록으로 바꿉니다. 여러 값을 업데이트하려면 쉼표로 구분된 목록을 사용하세요. 예를 들어 데이터 교환의 표시 이름과 기본 연락처를 업데이트하려면 displayName,primaryContact를 입력합니다.

요청 본문에서 다음 필드에 업데이트된 값을 지정하세요.

• 표시 이름
• 설명
• 문서
• 아이콘
• 기본 연락처

API를 사용하여 데이터 교환에서 수행할 수 있는 작업에 대한 자세한 내용은 projects.locations.dataExchanges 메서드를 참조하세요.

데이터 교환 보기

액세스 권한이 있는 조직의 모든 데이터 교환을 보려면 다음 단계를 따르세요.

Console

1. Google Cloud Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. Google Cloud 조직 내 데이터 교환 목록을 봅니다.

API

organizations.locations.dataExchanges.list 메서드를 사용합니다.

GET https://analyticshub.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

다음을 바꿉니다.

• ORGANIZATION_ID: 조직 ID입니다. 자세한 내용은 조직 ID 가져오기를 참조하세요.
• LOCATION: 기존 데이터 교환을 나열할 위치입니다.

데이터 교환 공유

Analytics Hub 게시자가 데이터 교환이 포함된 조직과 다른 조직에 속한 경우 게시자는 Analytics Hub에서 데이터 교환을 볼 수 없습니다. 데이터 교환 링크를 게시자와 공유해야 합니다.

1. Google Cloud Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. 데이터 교환 목록에서 옵션 더보기를 클릭합니다.

3. 공유 링크 복사를 클릭합니다.

사용자에게 데이터 교환 액세스 권한 부여

사용자에게 데이터 교환 액세스 권한을 부여하려면 해당 데이터 교환에 IAM 정책을 설정해야 합니다. 사전 정의된 IAM 사용자 역할에 대한 자세한 내용은 Analytics Hub 사용자 역할을 참조하세요. 이메일 별칭을 삭제하려면 다음 단계를 따르세요.

Console

1. Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. 권한을 설정할 데이터 교환 이름을 클릭합니다.

3. 권한 설정을 클릭합니다.

4. 주 구성원을 추가하려면 주 구성원 추가를 클릭합니다.

5. 새 주 구성원 필드에 액세스 권한을 부여할 이메일을 추가합니다.

6. 역할 선택에서 Analytics Hub 위로 마우스 포인터 올려놓고 다음 Identity and Access Management(IAM) 역할 중 하나를 선택합니다.

   • Analytics Hub 관리자
   • Analytics Hub 게시자
   • Analytics Hub 목록 관리자
   • Analytics Hub 구독자
   • Analytics Hub 뷰어

7. 저장을 클릭합니다.

API

1. projects.locations.dataExchanges.getIamPolicy 메서드를 사용하여 목록 getIamPolicy 메서드로 기존 정책을 읽습니다.

   POST https://analyticshub.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
   

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID입니다(예: my-project-1).
   • LOCATION: 데이터 교환 위치
   • DATAEXCHANGE_ID: 데이터 교환 ID

   Analytics Hub가 현재 정책을 반환합니다.

2. 구성원과 연결된 Identity and Access Management(IAM) 역할을 추가하거나 삭제하려면 텍스트 편집기를 사용하여 정책을 수정합니다. 구성원을 추가하려면 다음 형식을 사용하세요.

   • user:[e-mail]
   • group:[e-mail]
   • serviceAccount:[e-mail]
   • domain:example.domain.com

   예를 들어 group:[e-mail]에 roles/analyticshub.subscriber 역할을 부여하려면 다음 binding을 정책에 추가합니다.

   {
    "members": [
      "group:[e-mail]"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. projects.locations.dataExchanges.setIamPolicy 메서드를 사용하여 업데이트된 정책을 작성합니다. 요청 본문에 이전 단계에서 업데이트한 IAM 정책을 제공합니다.

   POST https://analyticshub.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
   

   요청 본문에 목록 세부정보를 제공합니다. 요청이 성공하면 응답 본문에 목록 세부정보가 포함됩니다.

Analytics Hub 관리자 만들기

데이터 교환을 관리하려면 Analytics Hub 관리자를 만들어야 합니다. 교환 관리자를 만들려면 프로젝트 또는 데이터 교환 수준에서 사용자에게 Analytics Hub 관리자 역할(roles/analyticshub.admin)을 부여해야 합니다.

관리자가 프로젝트의 모든 데이터 교환을 관리하게 하려면 해당 프로젝트에 Analytics Hub 관리자 역할을 부여합니다. 관리자가 특정 데이터 교환을 관리하도록 하려면 해당 데이터 교환에 대한 Analytics Hub 관리자 역할을 부여합니다.

데이터 교환 공개

기본적으로 데이터 교환은 비공개이며 해당 교환에 액세스할 수 있는 사용자 또는 그룹만 목록을 보거나 구독할 수 있습니다. 하지만 데이터 교환을 공개로 설정할 수 있습니다. Google Cloud 사용자(allauthenticated 사용자)가 공개 데이터 교환의 목록을 탐색하고 구독할 수 있습니다.

데이터 교환을 공개로 설정하려면 다음 단계를 따르세요.

1. allauthenticated 사용자가 목록을 볼 수 있도록 하려면 데이터 교환 수준에서 Analytics Hub 뷰어 역할을 부여해야 합니다.

2. allauthenticated 사용자가 목록을 구독하도록 하려면 데이터 교환 수준에서 Analytics Hub 구독자 역할을 부여해야 합니다.

3. 데이터 교환을 공개로 설정하려면 Google에 요청합니다.

참고: 공개 데이터 교환을 비공개로 변환하도록 요청할 수도 있습니다. 이렇게 하려면 데이터 교환의 권한 목록에서 allauthenticated 사용자를 삭제해야 합니다.

데이터 교환 삭제

데이터 교환이 삭제되면 데이터 내 모든 목록도 삭제됩니다. 하지만 공유 데이터 세트와 연결된 데이터 세트는 삭제되지 않습니다. 또한 프로젝트가 삭제되어도 해당 프로젝트 내의 데이터 교환은 삭제되지 않습니다. 프로젝트를 삭제하기 전에 이러한 데이터 교환을 삭제해야 합니다. 데이터 교환을 삭제하면 실행취소할 수 없습니다.

데이터 교환을 삭제하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud Console에서 Analytics Hub 페이지로 이동합니다.

   Analytics Hub로 이동

2. 데이터 교환 목록에서 삭제할 데이터 교환을 클릭합니다.

3. 교환 삭제를 클릭합니다.

4. 교환을 삭제하시겠습니까? 대화상자에서 delete를 입력하여 삭제를 확인합니다.

5. 삭제를 클릭합니다.

API

projects.locations.dataExchanges.delete 메서드를 사용합니다.

DELETE https://analyticshub.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

API를 사용하여 데이터 교환에서 수행할 수 있는 작업에 대한 자세한 내용은 projects.locations.dataExchanges 메서드를 참조하세요.

다음 단계

• 목록 관리 알아보기
• Analytics Hub 사용자 역할 부여 방법 알아보기
• 목록을 보고 구독하는 방법 알아보기