Endpunktprotokoll für Dataproc Metastore auswählen

Auf dieser Seite wird erläutert, wie Sie ein Endpunktprotokoll für Dataproc Metastore auswählen.

Sie wählen das Endpunktprotokoll aus, wenn Sie einen Dataproc Metastore-Dienst erstellen. Diese Auswahl wirkt sich auf die Funktionen aus, die Sie in Ihren Dienst einbinden und verwenden können. Beachten Sie, dass es einige Einschränkungen gibt, wenn Sie ein Endpunktprotokoll ändern möchten. Wählen Sie das für Ihre Anforderungen geeignete Protokoll aus.

Informationen zu den Unterschieden zwischen Endpunktprotokollen finden Sie unter Endpunktprotokolle.

Hinweise

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Dataproc-Metastores benötigen. Dabei wird das Prinzip der geringsten Berechtigung angewendet:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung metastore.services.create, die zum Erstellen eines Dataproc-Metastores erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen zu bestimmten Dataproc Metastore-Rollen und ‑Berechtigungen finden Sie unter Dataproc-Zugriff mit IAM verwalten.

Endpunktprotokoll auswählen

Die folgenden Beispiele zeigen eine gekürzte Version der Schritte, die Sie ausführen, um ein Endpunktprotokoll auszuwählen. Eine vollständige Anleitung für den gesamten Prozess finden Sie unter Dataproc Metastore erstellen.

Für einen neuen Dataproc Metastore-Dienst

So erstellen Sie einen Dataproc Metastore-Dienst und wählen zum ersten Mal das Endpunktprotokoll aus:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite „Dataproc Metastore“:

    Dataproc Metastore öffnen

  2. Klicken Sie im Navigationsmenü Dataproc Metastore auf Erstellen.

    Die Seite Dienst erstellen wird geöffnet.

  3. Wählen Sie im Bereich Endpunktprotokoll die Option Thrift oder gRPC aus.

    Thrift ist das standardmäßig ausgewählte Endpunktprotokoll.

    Sie können nur ein vorhandenes Endpunktprotokoll von Thrift auf gRPC aktualisieren. Wenn Sie von gRPC zu Thrift wechseln möchten, erstellen Sie einen neuen Dataproc Metastore-Dienst.

  4. Wählen Sie nach Bedarf die übrigen Konfigurationen für Ihren Dienst aus.

  5. Klicken Sie auf Senden, um den Dienst zu erstellen und zu starten.

    Wenn Sie einen gRPC-Endpunkt ausgewählt haben, müssen Sie Ihrem Dienst zusätzliche IAM-Berechtigungen gewähren. Weitere Informationen finden Sie unter Auf gRPC-Endpunkte zugreifen.

gcloud-CLI

  1. Führen Sie den folgenden gcloud metastore services create-Befehl aus, um ein Endpunktprotokoll auszuwählen:

    gcloud metastore services create SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift"

    Ersetzen Sie Folgendes:

    • SERVICE_ID: Der Name oder die ID Ihres Dataproc Metastore-Dienstes.

    • ENDPOINT_PROTOCOL: Das Endpunktprotokoll, das Sie für Ihren Dataproc Metastore verwenden möchten. Sie können entweder thrift oder grpc angeben.

      Thrift ist das standardmäßig ausgewählte Endpunktprotokoll.

      Sie können nur ein vorhandenes Endpunktprotokoll von Thrift auf gRPC aktualisieren. Wenn Sie von gRPC zu Thrift wechseln möchten, müssen Sie einen neuen Dienst erstellen.

  2. Prüfen Sie, ob der Dienst erfolgreich erstellt wurde.

    Wenn Sie ein gRPC-Endpunktprotokoll ausgewählt haben, müssen Sie Ihrem Konto zusätzliche IAM-Berechtigungen hinzufügen. Weitere Informationen finden Sie unter Auf gRPC-Endpunkte zugreifen.

Für einen vorhandenen Dataproc Metastore-Dienst

So aktualisieren Sie das Endpunktprotokoll eines vorhandenen Dataproc Metastore-Dienstes:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite „Dataproc Metastore“:

    Dataproc Metastore öffnen

  2. Klicken Sie auf der Seite Dataproc Metastore auf den zu aktualisierenden Dienst.

    Die Seite Dienstdetails wird geöffnet.

  3. Klicken Sie auf dem Tab Konfiguration auf Bearbeiten.

    Die Seite Dienst bearbeiten wird geöffnet.

  4. Wählen Sie im Bereich Endpunktprotokoll die Option gRPC aus.

  5. Klicken Sie auf Senden, um den Dienst zu aktualisieren.

    Nachdem Sie auf das gRPC-Endpunktprotokoll umgestellt haben, müssen Sie Ihrem Konto zusätzliche IAM-Berechtigungen hinzufügen. Weitere Informationen finden Sie unter Auf gRPC-Endpunkte zugreifen.

gcloud-CLI

  1. Führen Sie den folgenden gcloud metastore services update-Befehl aus, um ein Endpunktprotokoll zu aktualisieren:

    gcloud metastore services update SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL

    Ersetzen Sie Folgendes:

    • SERVICE: Der Name Ihres Dataproc Metastore-Dienstes.
    • ENDPOINT_PROTOCOL: Das Endpunktprotokoll, das Sie für Ihren Dataproc Metastore-Dienst aktualisieren möchten. Sie können nur grpc angeben.

  2. Prüfen Sie, ob die Aktualisierung erfolgreich war.

    Nachdem Sie auf einen gRPC-Endpunkt umgestellt haben, müssen Sie Ihrem Dienst zusätzliche IAM-Berechtigungen erteilen. Weitere Informationen finden Sie unter Auf gRPC-Endpunkte zugreifen.

URI-Wert des Endpunkts ermitteln

Console

Sie finden den Endpunkt-URI auf der Seite Dataproc Metastore.

  • Bei Thrift-Endpunkten beginnt der Wert URL mit thrift://.
  • Bei gRPC-Endpunkten beginnt der Wert URL mit https://.

Die folgende Abbildung zeigt ein Beispiel für einen Dataproc Metastore-Dienst, der mit einem gRPC-Endpunktprotokoll konfiguriert ist.

Dienstdetails-URL und hive.metastore.warehouse.dir-Werte

gcloud-CLI

Führen Sie den folgenden gcloud metastore services describe-Befehl aus, um den Endpunkt-URI aufzurufen:

gcloud metastore services describe SERVICE --format="get(endpointUri)"

Ersetzen Sie Folgendes:

  • SERVICE: Der Name Ihres Dataproc Metastore-Dienstes.

Nächste Schritte