목록 관리

콘솔

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

Analytics Hub API 사용 설정

gcloud

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

gcloud services enable analyticshub.googleapis.com

콘솔

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

   Analytics Hub로 이동

   액세스할 수 있는 모든 데이터 교환이 나열된 페이지가 표시됩니다.

2. 목록을 만들려는 데이터 교환 이름을 클릭합니다.

3. add_box 목록 만들기를 클릭합니다.

4. 목록 만들기 페이지의 표시 이름에 목록 이름을 입력합니다.

5. 상업용 목록을 만드는 경우 액세스 연락처 요청 필드를 입력해야 합니다. 구독자가 연락하려면 접수 양식의 이메일 또는 URL을 입력해야 합니다.

6. (선택사항) 다음 세부정보를 입력합니다.

   • 기본 연락처: 목록에 대한 기본 연락처의 이메일 또는 URL을 입력합니다.

   • 카테고리: 목록을 가장 잘 나타내는 최대 2개의 카테고리를 선택하세요. 구독자는 이러한 카테고리를 기준으로 목록을 필터링할 수 있습니다.

   • 제공업체: 제공업체 섹션을 펼치고 다음 필드에 세부정보를 지정합니다.

     • 제공업체 이름: 데이터 세트 제공업체의 이름입니다.
     • 제공업체 기본 연락처: 이메일 또는 데이터 세트 제공업체의 기본 연락처 URL입니다.

     구독자는 데이터 제공업체를 기준으로 목록을 필터링할 수 있습니다.

   • 게시자: 게시자 섹션을 펼치고 다음 필드에 세부정보를 지정합니다.

     • 게시자 이름: 목록을 만들려는 게시자의 이름입니다.
     • 게시자 기본 연락처: 데이터 세트 게시자 기본 연락처의 이메일 또는 URL입니다.

   • 아이콘: 목록의 아이콘입니다. PNG 및 JPEG 파일 형식이 지원됩니다. 아이콘의 파일 크기는 512KiB 미만이고 크기는 512 x 512픽셀 이하여야 합니다.

   • 설명: 목록에 대한 간단한 설명입니다. 구독자는 설명을 기반으로 목록을 검색할 수 있습니다.

7. 소스 데이터 세트에서 데이터 교환에 나열할 데이터 세트를 선택합니다. 소스 데이터 세트는 데이터 교환과 동일한 리전에 있어야 합니다. 목록이 생성된 후에는 이 필드를 업데이트할 수 없습니다.

8. 데이터 이그레스에서 적절한 데이터 이그레스 옵션을 선택합니다. 버전에 무관한 오퍼링 또는 Enterprise Plus 버전을 사용하는 구독자만 데이터 이그레스 제한이 적용되는 데이터를 쿼리할 수 있습니다.

   • 공유 데이터 세트에 데이터 이그레스 제한사항을 적용하지만 공유 데이터 세트의 쿼리 결과에는 적용하지 않으려면 공유 데이터 복사 및 내보내기 사용 중지를 선택합니다.
   • 공유 데이터 세트와 공유 데이터 세트의 쿼리 결과에 데이터 이그레스 제한사항을 적용하려면 쿼리 결과 복사 및 내보내기 사용 중지를 선택합니다. 그러면 자동으로 공유 데이터 복사 및 내보내기 사용 중지도 설정됩니다.
   • 공유 데이터 세트에 데이터 API 복사 및 내보내기 이그레스 제한사항을 적용하려면 API를 통한 테이블 복사 및 내보내기 사용 중지를 선택합니다. 그러면 자동으로 공유 데이터 복사 및 내보내기 사용 중지도 설정됩니다.

9. 선택사항: 목록 세부정보 섹션에서 공개 검색 가능 여부 전환 버튼을 클릭하여 공개 검색 가능 여부를 사용 설정합니다. Analytics Hub 뷰어 역할(roles/analyticshub.viewer)을 allUsers 또는 allAuthenticatedUsers에 부여해야 합니다. 자세한 내용은 목록에 역할 부여를 참조하세요. 교환이 이미 공개 상태인 경우 목록 권한이 이미 상속되므로 추가 조치를 취할 필요가 없습니다.

   공개적으로 검색 가능한 교환은 권한 상속으로 인해 비공개 목록을 가질 수 없지만 비공개 교환은 공개 목록을 가질 수 있습니다. 공개 목록을 만들려면 데이터 목록이 있는 프로젝트에 연결된 조직 및 결제 계정이 있어야 합니다.

10. (선택사항) 문서 > 마크다운 섹션에서 데이터 세트에서 실행할 수 있는 샘플 쿼리, 관련 문서 링크, 구독자가 데이터 세트를 사용하는 데 도움이 되는 정보와 같은 추가 정보를 입력할 수 있습니다.

11. 저장을 클릭합니다.

API

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

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

다음을 바꿉니다.

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

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

API를 사용하여 목록에 수행할 수 있는 작업에 대한 상세 설명은 projects.locations.dataExchanges.listings 메서드를 참조하세요.

콘솔

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

   Analytics Hub로 이동

2. 목록이 포함된 데이터 교환 이름을 클릭합니다.

3. 구독자를 추가할 목록을 클릭합니다.

4. person 권한 설정을 클릭합니다.

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

6. 새 주 구성원 필드에 목록 유형에 따라 다음 세부정보를 추가합니다.

   • 비공개 목록의 경우 액세스 권한을 부여할 ID의 이메일을 입력합니다.

   • 공개 목록의 경우 allAuthenticatedUsers를 추가합니다.

   • Google Cloud를 사용하지 않는 사용자를 포함하여 모든 사용자가 검색할 수 있는 공개 목록의 경우 allUsers를 추가합니다.

7. 역할 선택에서 Analytics Hub 위에 마우스 포인터를 올려놓고 목록 유형에 따라 다음 역할 중 하나를 선택합니다.

   • 상업용 목록의 경우 Analytics Hub 뷰어 역할을 선택합니다. 이 역할을 통해 사용자는 목록을 보고 액세스를 요청할 수 있습니다.

   • 비공개 또는 비상업적 공개 목록의 경우 Analytics Hub 구독자 역할을 선택합니다. 이 역할을 통해 사용자는 목록을 구독할 수 있습니다.

   자세한 내용은 Analytics Hub 구독자 및 뷰어 역할을 참조하세요.

8. 저장을 클릭합니다.

API

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

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   다음을 바꿉니다.

   • PROJECT_ID: 프로젝트 ID(예: my-project-1).
   • LOCATION: 목록이 포함된 데이터 교환 위치
   • DATAEXCHANGE_ID: 데이터 교환 ID
   • LISTING_ID: 목록 ID

   Analytics Hub는 응답에 현재 정책을 반환합니다.

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

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   예를 들어 group:subscribers@example.com에 roles/analyticshub.subscriber 역할을 부여하려면 다음 binding을 정책에 추가합니다.

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

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

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
   

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

API를 사용하여 목록에 수행할 수 있는 작업에 대한 상세 설명은 projects.locations.dataExchanges.listings 메서드를 참조하세요.

콘솔

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

   Analytics Hub로 이동

2. 구독을 관리하려는 목록이 포함된 데이터 교환 이름을 클릭합니다.

3. 모든 구독자를 나열할 목록을 클릭합니다.

4. 목록의 모든 구독자를 보려면 구독 관리를 클릭합니다.

   

5. (선택사항) 구독자 세부정보에 따라 결과를 필터링할 수 있습니다.

또는 공유 데이터 세트에 액세스할 수 있는 경우 다음 단계에 따라 구독자를 나열할 수 있습니다.

1. BigQuery 페이지로 이동

   BigQuery로 이동

2. 탐색기 창에서 프로젝트를 확장하고 공유 데이터 세트를 선택합니다.

3. person_add 공유 목록에서 구독 관리를 선택합니다.

SQL

다음 예시에서는 INFORMATION_SCHEMA.SCHEMATA_LINKS 뷰를 사용하여 us 리전에 있는 myproject의 공유 데이터 세트에 연결된 모든 데이터 세트를 나열합니다.

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

출력은 다음과 비슷합니다. 출력이 간소화되도록 일부 열을 생략합니다.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

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

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

다음을 바꿉니다.

• PROJECT_ID: 구독하려는 목록의 프로젝트 ID
• LOCATION: 구독하려는 목록의 위치
• DATAEXCHANGE_ID: 구독하려는 목록이 포함된 데이터 교환 ID
• LISTING_ID: 구독하려는 목록의 ID

콘솔

1. 목록의 모든 구독자를 나열하려면 모든 구독 보기의 Google Cloud 콘솔 안내를 따르세요.

2. 구독 탭을 클릭합니다.

3. 목록에서 구독자를 삭제하려면 삭제할 구독을 선택하고 delete 구독 삭제를 클릭합니다.

4. 구독을 삭제하시겠어요? 대화상자에서 remove를 입력하여 확인합니다.

5. 삭제를 클릭합니다.

API

projects.locations.subscriptions.revoke 메서드를 사용합니다.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

다음을 바꿉니다.

• PROJECT_ID: 삭제하려는 구독의 프로젝트 ID
• LOCATION: 삭제할 구독의 위치
• SUBSCRIPTION: 삭제하려는 구독의 ID

콘솔

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

   Analytics Hub로 이동

2. 목록이 포함된 데이터 교환 이름을 클릭합니다.

3. 업데이트할 목록을 클릭합니다.

4. mode_edit 목록 수정을 클릭합니다.

5. 필드의 값을 수정합니다. 목록의 소스 데이터 세트를 제외한 모든 값을 수정할 수 있습니다.

6. 선택사항:

   • 공개 검색 가능 여부를 사용 설정하는 경우 allUsers 또는 allAuthenticatedUsers에 Analytics Hub 뷰어 역할(roles/analyticshub.viewer)을 부여합니다. 자세한 내용은 목록에 역할 부여를 참조하세요.
   • 공개 검색 가능 여부를 사용 중지하는 경우 allAuthenticatedUsers 또는 에서 Analytics Hub 뷰어 역할(allUsers)을 삭제합니다. 공개 교환은 비공개 목록을 가질 수 없지만 비공개 교환은 공개 목록을 가질 수 있습니다.

7. 변경사항을 미리 보려면 미리보기를 클릭합니다.

8. 저장을 클릭하여 변경사항을 저장합니다.

API

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

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

UPDATEMASK를 업데이트할 필드 목록으로 바꿉니다. 여러 값을 업데이트하려면 쉼표로 구분된 목록을 사용합니다. 요청 본문에서 업데이트된 값을 지정합니다.

API를 사용하여 목록에 수행할 수 있는 작업에 대한 상세 설명은 projects.locations.dataExchanges.listings 메서드를 참조하세요.

콘솔

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

   Analytics Hub로 이동

2. 목록이 포함된 데이터 교환 이름을 클릭합니다.

3. 삭제할 목록을 클릭합니다.

4. delete 삭제를 클릭합니다.

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

6. 삭제를 클릭합니다.

API

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

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

API를 사용하여 목록에 수행할 수 있는 작업에 대한 상세 설명은 projects.locations.dataExchanges.listings 메서드를 참조하세요.