Usar Google Cloud CLI

Como alternativa a las APIs de Dataproc Metastore, puedes gestionar y acceder a los servicios de Dataproc Metastore mediante los comandos de gcloud metastoreGoogle Cloud CLI.

En esta página se explica cómo empezar a usar la CLI de Google Cloud para interactuar con Dataproc Metastore.

Antes de empezar

  1. 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.
  2. 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.

    Go to project selector

  3. 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

  4. Install the Google Cloud CLI.

  5. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  6. Para inicializar gcloud CLI, ejecuta el siguiente comando:

    gcloud init
  7. 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.

    Go to project selector

  8. 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

  9. Install the Google Cloud CLI.

  10. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  11. Para inicializar gcloud CLI, ejecuta el siguiente comando:

    gcloud init
  12. Empezar a usar la CLI de Google Cloud

    Para empezar a usar gcloud CLI, consulta la documentación de Google Cloud CLI. Para obtener ayuda sobre la herramienta, los recursos y los comandos, usa la marca --help:

    gcloud metastore --help
    

    La referencia de Google Cloud CLI también proporciona la información que muestra la marca --help.

    Definir propiedades de configuración predeterminadas en el cliente local

    La mayoría de los comandos de gcloud metastore requieren una ubicación, que se especifica mediante la marca --location o definiendo la ubicación predeterminada. También puedes definir el proyecto y el nivel predeterminados de tus servicios de Dataproc Metastore.

    1. Para definir el proyecto predeterminado, ejecuta el siguiente comando:
      gcloud config set project PROJECT_ID

      donde PROJECT_ID es el ID del proyecto Google Cloud al que pertenece el servicio Dataproc Metastore.

    2. Para configurar la ubicación de Dataproc Metastore, ejecuta el siguiente comando:
      gcloud config set metastore/location LOCATION

      donde LOCATION es una región admitida, como us-central1.

    3. Para configurar el nivel de Dataproc Metastore, ejecuta el siguiente comando:
      gcloud config set metastore/tier TIER

      donde TIER define la capacidad del nuevo servicio.

    4. Opcional: Para enumerar la configuración de gcloud CLI, ejecuta el siguiente comando:
      gcloud config list

    Siguientes pasos