Endpoints regionais

O Dataproc oferece suporte a endpoints regionais com base nas regiões do Compute Engine. É preciso especificar uma região, como "us-east1" ou "europe-west1", ao criar um cluster do Dataproc. O Dataproc isola recursos de cluster, como instâncias de VM, o Cloud Storage e o armazenamento de metadados, em uma zona dentro da região especificada.

Também é possível especificar uma zona dentro da região do cluster especificada, 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 escolherá uma zona dentro da região especificada para localizar recursos de clusters.

O namespace regional corresponde ao segmento /regions/REGION de 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 obrigató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