Use a Google Cloud CLI

Em alternativa à utilização das APIs Dataproc Metastore, pode gerir e aceder aos serviços Dataproc Metastore através dos comandos da CLI do Google Cloud gcloud metastore.

Esta página explica como começar a usar a CLI Google Cloud para que possa usá-la para interagir com o Dataproc Metastore.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Dataproc Metastore API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Dataproc Metastore API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Comece a usar a CLI Google Cloud

Para começar a usar a CLI gcloud, reveja a documentação da CLI Google Cloud. Pode obter ajuda para a ferramenta, os recursos e os comandos através da flag --help:

gcloud metastore --help

A referência da CLI do Google Cloud também fornece as informações apresentadas pela flag --help.

Defina propriedades de configuração predefinidas no cliente local

A maioria dos comandos do gcloud metastore requer uma localização, que especifica através da flag --location ou da definição da localização predefinida. Também pode definir o projeto e o nível predefinidos para os seus serviços do Dataproc Metastore.

1. Para definir o projeto predefinido, execute o seguinte comando:

   gcloud config set project PROJECT_ID

   onde PROJECT_ID é o ID do projeto ao qual o serviço Dataproc Metastore pertence. Google Cloud

2. Para configurar a localização do Dataproc Metastore, execute o seguinte comando:

   gcloud config set metastore/location LOCATION

   onde LOCATION é uma região suportada, como us-central1.

3. Para configurar o nível do Dataproc Metastore, execute o seguinte comando:

   gcloud config set metastore/tier TIER

   em que TIER define a capacidade do novo serviço.

4. Opcional: para listar a configuração da CLI gcloud, execute o seguinte comando:

   gcloud config list

O que se segue?

• Comandos gcloud do Dataproc Metastore
• Ativar a API
• Início rápido para implementar o Dataproc Metastore