Modello da Hive a Cloud Storage
Utilizza il modello da Hive a Cloud Storage di Managed Service for Apache Spark per estrarre i dati da Hive a Cloud Storage.
Utilizzare il modello
Esegui il modello utilizzando gcloud CLI o l'API Managed Service for Apache Spark.
gcloud
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
- PROJECT_ID: obbligatorio. Il tuo Google Cloud ID progetto elencato in nelle impostazioni IAM.
- REGION: obbligatorio. Regione Compute Engine.
- TEMPLATE_VERSION: obbligatorio. Specifica
latestper l'ultima versione del modello o la data di una versione specifica, ad esempio2023-03-17_v0.1.0-beta(visita gs://templates-binaries o eseguigcloud storage ls gs://templates-binariesper elencare le versioni del modello disponibili). - SUBNET: facoltativo. Se non viene specificata una subnet, viene selezionata la subnet
nella REGION specificata nella rete
default.Esempio:
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME - HOST e PORT: obbligatorio.
Nome host o indirizzo IP e porta dell'host del database Hive di origine.
Esempio:
10.0.0.33 - TABLE: obbligatorio. Nome della tabella di input Hive.
- DATABASE: obbligatorio. Nome del database di input Hive.
- CLOUD_STORAGE_OUTPUT_PATH: obbligatorio. Percorso di Cloud Storage
in cui verranno archiviati gli output.
Esempio:
gs://templates/hive_to_cloud_storage_output - FORMAT: facoltativo. Formato dei dati di output. Opzioni:
avro,parquet,csv, ojson. Valore predefinito:avro. Nota: seavro, devi aggiungerefile:///usr/lib/spark/connector/spark-avro.jaral flag gcloud CLIjarso al campo API.Esempio (il prefisso
file://fa riferimento a un file JAR di Managed Service for Apache Spark):--jars=file:///usr/lib/spark/connector/spark-avro.jar,[, ... other jars] - HIVE_PARTITION_COLUMN: facoltativo. Colonna per partizionare i dati Hive.
- MODE: obbligatorio. Modalità di scrittura per l'output di Cloud Storage.
Opzioni:
append,overwrite,ignore, oerrorifexists. - SERVICE_ACCOUNT: facoltativo. Se non viene specificato, viene utilizzato il service account Compute Engine predefinito.
- PROPERTY e PROPERTY_VALUE:
facoltativo. Elenco separato da virgole di
proprietà Spark=
valuecoppie. - LABEL e LABEL_VALUE:
facoltativo. Elenco separato da virgole di coppie
label=value. - LOG_LEVEL: facoltativo. Livello di logging. Può essere uno dei seguenti valori:
ALL,DEBUG,ERROR,FATAL,INFO,OFF,TRACE, oWARN. Valore predefinito:INFO. -
KMS_KEY: facoltativo. La chiave Cloud Key Management Service da utilizzare per la crittografia. Se non viene specificata una chiave, i dati vengono criptati a riposo utilizzando Google-owned and Google-managed encryption key.
Esempio:
projects/PROJECT_ID/regions/REGION/keyRings/KEY_RING_NAME/cryptoKeys/KEY_NAME
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud dataproc batches submit spark \ --class=com.google.cloud.dataproc.templates.main.DataProcTemplate \ --version="1.2" \ --project="PROJECT_ID" \ --region="REGION" \ --jars="gs://templates-binaries/TEMPLATE_VERSION/java/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="1.2" ` --project="PROJECT_ID" ` --region="REGION" ` --jars="gs://templates-binaries/TEMPLATE_VERSION/java/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="1.2" ^ --project="PROJECT_ID" ^ --region="REGION" ^ --jars="gs://templates-binaries/TEMPLATE_VERSION/java/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
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: obbligatorio. Il tuo Google Cloud ID progetto elencato in nelle impostazioni IAM.
- REGION: obbligatorio. Regione Compute Engine.
- TEMPLATE_VERSION: obbligatorio. Specifica
latestper l'ultima versione del modello o la data di una versione specifica, ad esempio2023-03-17_v0.1.0-beta(visita gs://templates-binaries o eseguigcloud storage ls gs://templates-binariesper elencare le versioni del modello disponibili). - SUBNET: facoltativo. Se non viene specificata una subnet, viene selezionata la subnet
nella REGION specificata nella rete
default.Esempio:
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME - HOST e PORT: obbligatorio.
Nome host o indirizzo IP e porta dell'host del database Hive di origine.
Esempio:
10.0.0.33 - TABLE: obbligatorio. Nome della tabella di input Hive.
- DATABASE: obbligatorio. Nome del database di input Hive.
- CLOUD_STORAGE_OUTPUT_PATH: obbligatorio. Percorso di Cloud Storage
in cui verranno archiviati gli output.
Esempio:
gs://templates/hive_to_cloud_storage_output - FORMAT: facoltativo. Formato dei dati di output. Opzioni:
avro,parquet,csv, ojson. Valore predefinito:avro. Nota: seavro, devi aggiungerefile:///usr/lib/spark/connector/spark-avro.jaral flag gcloud CLIjarso al campo API.Esempio (il prefisso
file://fa riferimento a un file JAR di Managed Service for Apache Spark):--jars=file:///usr/lib/spark/connector/spark-avro.jar,[, ... other jars] - HIVE_PARTITION_COLUMN: facoltativo. Colonna per partizionare i dati Hive.
- MODE: obbligatorio. Modalità di scrittura per l'output di Cloud Storage.
Opzioni:
append,overwrite,ignore, oerrorifexists. - SERVICE_ACCOUNT: facoltativo. Se non viene specificato, viene utilizzato il service account Compute Engine predefinito.
- PROPERTY e PROPERTY_VALUE:
facoltativo. Elenco separato da virgole di
proprietà Spark=
valuecoppie. - LABEL e LABEL_VALUE:
facoltativo. Elenco separato da virgole di coppie
label=value. - LOG_LEVEL: facoltativo. Livello di logging. Può essere uno dei seguenti valori:
ALL,DEBUG,ERROR,FATAL,INFO,OFF,TRACE, oWARN. Valore predefinito:INFO. -
KMS_KEY: facoltativo. La chiave Cloud Key Management Service da utilizzare per la crittografia. Se non viene specificata una chiave, i dati vengono criptati a riposo utilizzando Google-owned and Google-managed encryption key.
Esempio:
projects/PROJECT_ID/regions/REGION/keyRings/KEY_RING_NAME/cryptoKeys/KEY_NAME
Metodo HTTP e URL:
POST https://dataproc.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/batches
Corpo JSON della richiesta:
{
"environmentConfig":{
"executionConfig":{
"subnetworkUri":"SUBNET",
"kmsKey": "KMS_KEY",
"serviceAccount": "SERVICE_ACCOUNT"
}
},
"labels": {
"LABEL": "LABEL_VALUE"
},
"runtimeConfig": {
"version": "1.2",
"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://templates-binaries/TEMPLATE_VERSION/java/templates.jar"
]
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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"
}
}