Endpoints regionais

O Dataproc é compatível com endpoints regionais com base nas regiões do Compute Engine. É necessário especificar uma região, como "us-east1" ou "europe-west1", ao criar um cluster do Dataproc. O Dataproc isolará os recursos do cluster, como instâncias de VM e o Cloud Storage e o armazenamento de metadados, em uma zona na região especificada.

Você pode especificar uma zona na região do cluster especificado, como "us-east1-a" ou "europe-west1-b", ao criar um cluster. Se você não especificar a zona, a Colocação em zona automática do Dataproc vai escolher uma zona dentro da região de cluster especificada para localizar os recursos de clusters.

O namespace regional corresponde ao segmento /regions/REGION dos URIs de recursos do Dataproc. Consulte, por exemplo, o cluster networkUri.

Semântica do endpoint regional

Os nomes de endpoint regionais seguem uma convenção de nomenclatura padrão com base em regiões do Google Compute Engine. Por exemplo, o nome da região central dos EUA é us-central1 e o nome da região da Europa Ocidental é europe-west1. Execute o comando gcloud compute regions list para ver uma lista de regiões disponíveis.

Crie um cluster

gcloud

Ao criar um cluster, especifique uma região usando a sinalização --region necessária.

gcloud dataproc clusters create CLUSTER_NAME \
    --region=REGION \
    other args ...

API REST

Use o parâmetro de URL REGION em uma solicitação clusters.create para especificar a região do cluster.

gRPC

Defina o endereço de transporte do cliente para o endpoint regional usando o seguinte padrão:

REGION-dataproc.googleapis.com

Exemplo de Python (google-cloud-python):

from google.cloud import dataproc_v1
from google.cloud.dataproc_v1.gapic.transports import cluster_controller_grpc_transport

transport = cluster_controller_grpc_transport.ClusterControllerGrpcTransport(
    address='us-central1-dataproc.googleapis.com:443')
client = dataproc_v1.ClusterControllerClient(transport)

project_id = 'my-project'
region = 'us-central1'
cluster = {...}

Exemplo de Java (google-cloud-java):

ClusterControllerSettings settings =
     ClusterControllerSettings.newBuilder()
        .setEndpoint("us-central1-dataproc.googleapis.com:443")
        .build();
 try (ClusterControllerClient clusterControllerClient = ClusterControllerClient.create(settings)) {
   String projectId = "my-project";
   String region = "us-central1";
   Cluster cluster = Cluster.newBuilder().build();
   Cluster response =
       clusterControllerClient.createClusterAsync(projectId, region, cluster).get();
 }

Console

Especifique uma região do Dataproc na seção "Local" do painel Configurar cluster na página Criar um cluster do Dataproc no console do Google Cloud.

A seguir