Data Catalog 리전

Data Catalog 리소스는 리전이라고 하는 전 세계 여러 곳에서 호스팅됩니다. 리전은 리소스에 액세스할 수 있는 특정한 지리적 위치입니다. 자세한 내용은 위치 및 리전을 참조하세요.

네트워크 지연 시간을 줄이기 위해 API 엔드포인트를 사용할 위치와 가까운 리전으로 사용하는 것이 좋습니다. 예를 들어 아시아에서 Data Catalog에 액세스하려는 경우 타이완의 엔드포인트를 사용할 수 있습니다.

지원되는 리전

리전 리전 엔드포인트 지원되는 리소스
미주
몬트리올 northamerica-northeast1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
토론토 northamerica-northeast2-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목, 데이터 계보
상파울루 southamerica-east1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
산티아고 southamerica-west1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
아이오와 us-central1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
사우스캐롤라이나 us-east1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
북버지니아 us-east4-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
콜럼버스 us-east5-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
댈러스 us-south1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
북버지니아 aws-us-east-1-datacatalog.googleapis.com, azure-eastus2-datacatalog.googleapis.com 태그 템플릿, BigQuery(연결 제외), 사용자 작성 항목
오리건 us-west1-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목, 데이터 계보
오리건 aws-us-west-2-datacatalog.googleapis.com 태그 템플릿, BigQuery(연결 제외), 사용자 작성 항목
워싱턴 azure-westus2-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목
로스앤젤레스 us-west2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
솔트레이크시티 us-west3-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
라스베이거스 us-west4-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
유럽
바르샤바 europe-central2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
핀란드 europe-north1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
벨기에 europe-west1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
아일랜드 aws-eu-west-1-datacatalog.googleapis.com 태그 템플릿, BigQuery(연결 제외), 사용자 작성 항목
런던 europe-west2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
프랑크푸르트 europe-west3-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
프랑크푸르트 aws-eu-central-1-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목
네덜란드 europe-west4-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목, 데이터 계보
취리히 europe-west6-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
밀라노 europe-west8-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
파리 europe-west9-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
베를린 europe-west10-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목
토리노 europe-west12-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목
마드리드 europe-southwest1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
아시아 태평양
타이완 asia-east1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
홍콩 asia-east2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
도쿄 asia-northeast1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
오사카 asia-northeast2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
서울 asia-northeast3-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
서울 aws-ap-northeast-2-datacatalog.googleapis.com 태그 템플릿, BigQuery(연결 제외), 사용자 작성 항목
뭄바이 asia-south1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
델리 asia-south2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
싱가포르 asia-southeast1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
자카르타 asia-southeast2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
시드니 australia-southeast1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
시드니 aws-ap-southeast-2-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목
멜버른 australia-southeast2-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목, 데이터 계보
중동
도하 me-central1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목
담맘 me-central2-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목
텔아비브 me-west1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보
아프리카
요하네스버그 africa-south1-datacatalog.googleapis.com 태그 템플릿, BigQuery, 사용자 작성 항목
멀티 리전 멀티 리전 엔드포인트 지원되는 리소스
아시아 asia-datacatalog.googleapis.com 태그 템플릿, 사용자 작성 항목, 데이터 계보
유럽 연합 eu-datacatalog.googleapis.com BigQuery, 태그 템플릿, 사용자 작성 항목, 데이터 계보
미국 us-datacatalog.googleapis.com BigQuery, 태그 템플릿, 사용자 작성 항목, 데이터 계보
BigQuery Omni 리전 리전 엔드포인트 지원되는 리소스
AWS 아시아 태평양(서울) aws-ap-northeast-2-datacatalog.googleapis.com 데이터 계보
AWS EU 서부(아일랜드) aws-eu-west-1-datacatalog.googleapis.com 데이터 계보
AWS 미국 동부(북 버지니아) aws-us-east-1-datacatalog.googleapis.com 데이터 계보
AWS 미국 서부(오리건) aws-us-west-2-datacatalog.googleapis.com 데이터 계보
Azure 미국 동부 2(버지니아) azure-eastus2-datacatalog.googleapis.com 데이터 계보

멀티 리전(us, eu)

euus 같은 멀티 리전은 Data Catalog가 리전 내 어느 곳이든 리소스를 복제하고 제공할 수 있는 특수한 리전입니다.

리전 API로 리소스 액세스

리소스는 리전 엔드포인트를 사용하여 액세스할 수 있습니다(에 나열됨). 클라이언트 라이브러리를 사용하여 엔드포인트를 구성할 수 있습니다.

이전 버전과의 호환성을 위해 리전 API는 몇 가지 제한이 있지만 datacatalog.googleapis.com 엔드포인트에서 계속 지원됩니다(HTTP 배치 및 gRPC 참조). 리전 API에는 리전 엔드포인트를 사용하는 것이 좋습니다.

비 리전 API

데이터 애셋은 특정 리전에 위치하지만 Data Catalog의 검색 기능은 전역으로 범위가 지정됩니다. SearchCatalogLookupEntry와 같은 비 리전 API는 모든 리전의 애셋을 반환하며 datacatalog.googleapis.com 엔드포인트로 액세스할 수 있습니다.

HTTP 배치 지원

Data Catalog는 HTTP 배치를 지원하므로 단일 요청에 여러 API 호출을 일괄적으로 요청할 수 있습니다.

리전 API에 HTTP 배치를 사용하는 경우 몇 가지 제약이 있습니다.

  • HTTP 배치 요청에는 같은 리전에 속한 리소스의 API 요청만 포함해야 합니다.
  • 리전 API를 일괄 요청할 때는 리전 엔드포인트를 사용해야 합니다. datacatalog.googleapis.com은 일괄 요청되는 리전 API를 지원하지 않습니다. 리전 및 비 리전 요청은 일괄적으로 처리할 수 없습니다.
  • 비 리전 종속 API(SearchCatalog 및 LookupEntry)는 datacatalog.googleapis.com 엔드포인트를 사용하여 일괄 처리될 수 있습니다.

HTTP 배치 사용 여부를 잘 모르겠다면 다음 안내를 따르세요.

  • http://datacatalog.googleapis.com/batch와 같이 경로가 /batch로 설정된 HTTP 요청을 직접 호출하는지 확인합니다.
  • Google API 클라이언트 라이브러리를 사용하는 경우:

    • 자바: BatchRequest를 사용하여 API를 호출합니다.
    • Python: BatchHTTP 요청을 사용하여 API를 호출합니다.
    • 다른 라이브러리에 비슷한 결합이 존재합니다(라이브러리 특정 문서 참조).

gRPC 지원

리전 API에 gRPC를 사용하려면 리전 엔드포인트를 사용하는 것이 좋습니다.

수동으로 만든 gRPC 라이브러리를 사용하여 datacatalog.googleapis.com 엔드포인트를 호출하는 경우 요청에 locations=<region> 태그가 있는 x-google-request-params 헤더를 지정해야 합니다. gRPC를 내부적으로 사용하는 기존 Google Cloud 클라이언트 라이브러리에는 이미 이 기능이 구현되어 있습니다.