Use the Google Cloud CLI

As an alternative to using the Dataproc Metastore APIs, you can manage and access Dataproc Metastore services using Google Cloud CLI gcloud metastore commands.

This page explains how to get started using the Google Cloud CLI, so you can use it to interact with Dataproc Metastore.

Before you begin

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.

   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

3. Enable the Dataproc Metastore API.

   Enable the API

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

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

   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

7. Enable the Dataproc Metastore API.

   Enable the API

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

Get started with the Google Cloud CLI

To start with the gcloud CLI, review the Google Cloud CLI Documentation. You can get help for the tool, resources, and commands by using the --help flag:

gcloud metastore --help

The Google Cloud CLI reference also provides the information shown by the --help flag.

Set default configuration properties in your local client

Most gcloud metastore commands require a location, which you specify using the --location flag or by setting the default location. You can also set the default project and tier for your Dataproc Metastore services.

1. To set the default project, run the following command:

   gcloud config set project PROJECT_ID

   where PROJECT_ID is the ID of the Google Cloud project that the Dataproc Metastore service belongs to.

2. To configure the Dataproc Metastore location, run the following command:

   gcloud config set metastore/location LOCATION

   where LOCATION is a supported region such as us-central1.

3. To configure the Dataproc Metastore tier, run the following command:

   gcloud config set metastore/tier TIER

   where TIER sets the capacity of the new service.

4. Optional: To list the configuration for the gcloud CLI, run the following command:

   gcloud config list

What's next

• Dataproc Metastore gcloud commands
• Enabling the API
• Quickstart for deploying Dataproc Metastore