Vorlage „Hive zu Cloud Storage“
Mit der Vorlage „Managed Service for Apache Spark Hive zu Cloud Storage“ können Sie Daten aus Hive in Cloud Storage extrahieren.
Vorlage verwenden
Führen Sie die Vorlage mit der gcloud CLI oder der Managed Service for Apache Spark API aus.
gcloud
Ersetzen Sie vor der Verwendung der folgenden Befehlsdaten die Platzhalter durch die entsprechenden Werte:
- PROJECT_ID: erforderlich. Ihre Google Cloud Projekt-ID, die in den IAM-Einstellungen aufgeführt ist.
- REGION: erforderlich. Compute Engine -Region.
- TEMPLATE_VERSION: erforderlich. Geben Sie
latestfür die neueste Vorlagenversion oder das Datum einer bestimmten Version an, z. B.2023-03-17_v0.1.0-beta. Unter gs://dataproc-templates-binaries oder mit dem Befehlgcloud storage ls gs://dataproc-templates-binarieskönnen Sie die verfügbaren Vorlagenversionen auflisten. - SUBNET: optional. Wenn kein Subnetzwerk angegeben ist, wird das Subnetzwerk
in der angegebenen REGION im
defaultNetzwerk ausgewählt.Beispiel:
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME - HOST und PORT: erforderlich.
Hostname oder IP-Adresse und Port des Quellhosts der Hive-Datenbank.
Beispiel:
10.0.0.33 - TABLE: erforderlich. Name der Hive-Eingabetabelle.
- DATABASE: erforderlich. Name der Hive-Eingabedatenbank.
- CLOUD_STORAGE_OUTPUT_PATH: erforderlich. Cloud Storage
Pfad, in dem die Ausgabe gespeichert wird.
Beispiel:
gs://templates/hive_to_cloud_storage_output - FORMAT: optional. Ausgabedatenformat. Optionen:
avro,parquet,csv, oderjson. Standardeinstellung:avro. Hinweis: Wenn Sieavroverwenden, müssen Siefile:///usr/lib/spark/connector/spark-avro.jardemjarsgcloud CLI-Flag oder dem API-Feld hinzufügen.Beispiel (das Präfix
file://verweist auf eine JAR-Datei von Managed Service for Apache Spark):--jars=file:///usr/lib/spark/connector/spark-avro.jar,[, ... other jars] - HIVE_PARTITION_COLUMN: optional. Spalte zum Partitionieren von Hive-Daten.
- MODE: erforderlich. Schreibmodus für die Cloud Storage-Ausgabe.
Optionen:
append,overwrite,ignore, odererrorifexists. - SERVICE_ACCOUNT: optional. Wenn nicht angegeben, wird das Compute Engine-Standarddienstkonto verwendet.
- PROPERTY und PROPERTY_VALUE:
optional. Durch Kommas getrennte Liste von
Spark-Eigenschaft=
valuePaaren. - LABEL und LABEL_VALUE:
optional. Durch Kommas getrennte Liste von Paaren im Format
label=value. - LOG_LEVEL: optional. Logging-Ebene. Mögliche Werte:
ALL,DEBUG,ERROR,FATAL,INFO,OFF,TRACEoderWARN. Standardeinstellung:INFO. -
KMS_KEY: optional. Der Cloud Key Management Service-Schlüssel, der für die Verschlüsselung verwendet werden soll. Wenn kein Schlüssel angegeben ist, werden inaktive Daten verschlüsselt mit einem Google-owned and Google-managed encryption key.
Beispiel:
projects/PROJECT_ID/regions/REGION/keyRings/KEY_RING_NAME/cryptoKeys/KEY_NAME
Führen Sie den folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud dataproc batches submit spark \ --class=com.google.cloud.dataproc.templates.main.DataProcTemplate \ --version="2.3" \ --project="PROJECT_ID" \ --region="REGION" \ --jars="gs://dataproc-templates-binaries/TEMPLATE_VERSION/java/dataproc-templates.jar" \ --subnet="SUBNET" \ --kms-key="KMS_KEY" \ --service-account="SERVICE_ACCOUNT" \ --properties="spark.hadoop.hive.metastore.uris=thrift://HOST:PORT,PROPERTY=PROPERTY_VALUE" \ --labels="LABEL=LABEL_VALUE" \ -- --template=HIVETOGCS \ --templateProperty log.level="LOG_LEVEL" \ --templateProperty hive.input.table="TABLE" \ --templateProperty hive.input.db="DATABASE" \ --templateProperty hive.gcs.output.path="CLOUD_STORAGE_OUTPUT_PATH" \ --templateProperty hive.gcs.output.format="FORMAT" \ --templateProperty hive.partition.col="HIVE_PARTITION_COLUMN" \ --templateProperty hive.gcs.save.mode="MODE"
Windows (PowerShell)
gcloud dataproc batches submit spark ` --class=com.google.cloud.dataproc.templates.main.DataProcTemplate ` --version="2.3" ` --project="PROJECT_ID" ` --region="REGION" ` --jars="gs://dataproc-templates-binaries/TEMPLATE_VERSION/java/dataproc-templates.jar" ` --subnet="SUBNET" ` --kms-key="KMS_KEY" ` --service-account="SERVICE_ACCOUNT" ` --properties="spark.hadoop.hive.metastore.uris=thrift://HOST:PORT,PROPERTY=PROPERTY_VALUE" ` --labels="LABEL=LABEL_VALUE" ` -- --template=HIVETOGCS ` --templateProperty log.level="LOG_LEVEL" ` --templateProperty hive.input.table="TABLE" ` --templateProperty hive.input.db="DATABASE" ` --templateProperty hive.gcs.output.path="CLOUD_STORAGE_OUTPUT_PATH" ` --templateProperty hive.gcs.output.format="FORMAT" ` --templateProperty hive.partition.col="HIVE_PARTITION_COLUMN" ` --templateProperty hive.gcs.save.mode="MODE"
Windows (cmd.exe)
gcloud dataproc batches submit spark ^ --class=com.google.cloud.dataproc.templates.main.DataProcTemplate ^ --version="2.3" ^ --project="PROJECT_ID" ^ --region="REGION" ^ --jars="gs://dataproc-templates-binaries/TEMPLATE_VERSION/java/dataproc-templates.jar" ^ --subnet="SUBNET" ^ --kms-key="KMS_KEY" ^ --service-account="SERVICE_ACCOUNT" ^ --properties="spark.hadoop.hive.metastore.uris=thrift://HOST:PORT,PROPERTY=PROPERTY_VALUE" ^ --labels="LABEL=LABEL_VALUE" ^ -- --template=HIVETOGCS ^ --templateProperty log.level="LOG_LEVEL" ^ --templateProperty hive.input.table="TABLE" ^ --templateProperty hive.input.db="DATABASE" ^ --templateProperty hive.gcs.output.path="CLOUD_STORAGE_OUTPUT_PATH" ^ --templateProperty hive.gcs.output.format="FORMAT" ^ --templateProperty hive.partition.col="HIVE_PARTITION_COLUMN" ^ --templateProperty hive.gcs.save.mode="MODE"
REST
Ersetzen Sie vor der Verwendung der Anfragedaten, die Platzhalter durch die entsprechenden Werte:
- PROJECT_ID: erforderlich. Ihre Google Cloud Projekt-ID, die in den IAM-Einstellungen aufgeführt ist.
- REGION: erforderlich. Compute Engine -Region.
- TEMPLATE_VERSION: erforderlich. Geben Sie
latestfür die neueste Vorlagenversion oder das Datum einer bestimmten Version an, z. B.2023-03-17_v0.1.0-beta. Unter gs://dataproc-templates-binaries oder mit dem Befehlgcloud storage ls gs://dataproc-templates-binarieskönnen Sie die verfügbaren Vorlagenversionen auflisten. - SUBNET: optional. Wenn kein Subnetzwerk angegeben ist, wird das Subnetzwerk
in der angegebenen REGION im
defaultNetzwerk ausgewählt.Beispiel:
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME - HOST und PORT: erforderlich.
Hostname oder IP-Adresse und Port des Quellhosts der Hive-Datenbank.
Beispiel:
10.0.0.33 - TABLE: erforderlich. Name der Hive-Eingabetabelle.
- DATABASE: erforderlich. Name der Hive-Eingabedatenbank.
- CLOUD_STORAGE_OUTPUT_PATH: erforderlich. Cloud Storage
Pfad, in dem die Ausgabe gespeichert wird.
Beispiel:
gs://templates/hive_to_cloud_storage_output - FORMAT: optional. Ausgabedatenformat. Optionen:
avro,parquet,csv, oderjson. Standardeinstellung:avro. Hinweis: Wenn Sieavroverwenden, müssen Siefile:///usr/lib/spark/connector/spark-avro.jardemjarsgcloud CLI-Flag oder dem API-Feld hinzufügen.Beispiel (das Präfix
file://verweist auf eine JAR-Datei von Managed Service for Apache Spark):--jars=file:///usr/lib/spark/connector/spark-avro.jar,[, ... other jars] - HIVE_PARTITION_COLUMN: optional. Spalte zum Partitionieren von Hive-Daten.
- MODE: erforderlich. Schreibmodus für die Cloud Storage-Ausgabe.
Optionen:
append,overwrite,ignore, odererrorifexists. - SERVICE_ACCOUNT: optional. Wenn nicht angegeben, wird das Compute Engine-Standarddienstkonto verwendet.
- PROPERTY und PROPERTY_VALUE:
optional. Durch Kommas getrennte Liste von
Spark-Eigenschaft=
valuePaaren. - LABEL und LABEL_VALUE:
optional. Durch Kommas getrennte Liste von Paaren im Format
label=value. - LOG_LEVEL: optional. Logging-Ebene. Mögliche Werte:
ALL,DEBUG,ERROR,FATAL,INFO,OFF,TRACEoderWARN. Standardeinstellung:INFO. -
KMS_KEY: optional. Der Cloud Key Management Service-Schlüssel, der für die Verschlüsselung verwendet werden soll. Wenn kein Schlüssel angegeben ist, werden inaktive Daten verschlüsselt mit einem Google-owned and Google-managed encryption key.
Beispiel:
projects/PROJECT_ID/regions/REGION/keyRings/KEY_RING_NAME/cryptoKeys/KEY_NAME
HTTP-Methode und URL:
POST https://dataproc.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/batches
JSON-Text der Anfrage:
{
"environmentConfig":{
"executionConfig":{
"subnetworkUri":"SUBNET",
"kmsKey": "KMS_KEY",
"serviceAccount": "SERVICE_ACCOUNT"
}
},
"labels": {
"LABEL": "LABEL_VALUE"
},
"runtimeConfig": {
"version": "2.3",
"properties": {
"spark.hadoop.hive.metastore.uris":"thrift://HOST:PORT",
"PROPERTY": "PROPERTY_VALUE"
}
},
"sparkBatch":{
"mainClass":"com.google.cloud.dataproc.templates.main.DataProcTemplate",
"args":[
"--template","HIVETOGCS",
"--templateProperty","log.level=LOG_LEVEL",
"--templateProperty","hive.input.table=TABLE",
"--templateProperty","hive.input.db=DATABASE",
"--templateProperty","hive.gcs.output.path=CLOUD_STORAGE_OUTPUT_PATH",
"--templateProperty","hive.gcs.output.format=FORMAT",
"--templateProperty","hive.partition.col=HIVE_PARTITION_COLUMN",
"--templateProperty","hive.gcs.save.mode=MODE"
],
"jarFileUris":[
"file:///usr/lib/spark/connector/spark-avro.jar",
"gs://dataproc-templates-binaries/TEMPLATE_VERSION/java/dataproc-templates.jar"
]
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/PROJECT_ID/regions/REGION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.dataproc.v1.BatchOperationMetadata",
"batch": "projects/PROJECT_ID/locations/REGION/batches/BATCH_ID",
"batchUuid": "de8af8d4-3599-4a7c-915c-798201ed1583",
"createTime": "2023-02-24T03:31:03.440329Z",
"operationType": "BATCH",
"description": "Batch"
}
}