Use the Google Cloud SDK

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

This page explains how to get started using the Cloud SDK, 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.

    Go to project selector

  3. Enable the Dataproc Metastore API.

    Enable the API

  4. Install and initialize the Cloud SDK.
  5. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Enable the Dataproc Metastore API.

    Enable the API

  7. Install and initialize the Cloud SDK.

Get started with the gcloud command-line tool

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

gcloud metastore --help

The Cloud SDK 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 tool, run the following command:
    gcloud config list

What's next