Aggiornare un servizio Dataproc Metastore

Questa pagina spiega come aggiornare un servizio Dataproc Metastore.

Puoi aggiornare il servizio Dataproc Metastore per modificare le impostazioni di configurazione o per attivare o disattivare le funzionalità facoltative.

Prima di iniziare

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per aggiornare un servizio Dataproc Metastore, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto, in base al principio del privilegio minimo:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione metastore.services.update necessaria per aggiornare un servizio Dataproc Metastore.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni su ruoli e autorizzazioni specifici di Dataproc Metastore, consulta la panoramica di IAM di Dataproc Metastore.

Informazioni sull'aggiornamento di un servizio

Puoi aggiornare i seguenti parametri di Dataproc Metastore.

  • Numero porta. Aggiorna il numero di porta TCP dell'interfaccia Apache Thrift.
  • Livello di servizio. Passa dal livello di servizio Developer al livello di servizio Enterprise. Questi livelli influiscono sulla capacità del servizio.
  • Sincronizzazione di Data Catalog. Attiva o disattiva la funzionalità di sincronizzazione di Data Catalog.
  • Periodo di manutenzione. Modifica la frequenza del periodo di manutenzione, inclusi Giorno della settimana e Ora del giorno.
  • Kerberos. Attiva o disattiva l'autenticazione Kerberos. Se in precedenza è stata attivata, puoi aggiornare i file di configurazione di Kerberos.
  • Configurazioni del metastore Hive. Aggiorna la posizione della directory del warehouse Hive.
  • Configurazione della versione ausiliaria (anteprima). Attiva, disattiva o aggiungi versioni ausiliarie aggiuntive.
  • Etichette. Aggiungi o rimuovi etichette facoltative che descrivono i metadati.
  • Fattore di scalabilità. Modifica il fattore di scalabilità. Puoi attivare o disattivare la scalabilità automatica e aggiornare i fattori di scalabilità minimi o massimi.

Aggiorna un servizio

Prima di eseguire un aggiornamento, tieni presente quanto segue:

  • Puoi eseguire un solo job di aggiornamento alla volta (per ogni servizio Dataproc Metastore).
  • Puoi aggiornare più parametri in un unico job di aggiornamento.
  • Puoi comunque utilizzare Dataproc Metastore durante l'aggiornamento.

Se l'aggiornamento va a buon fine, Dataproc Metastore entra automaticamente nello stato attivo. Se l'aggiornamento non va a buon fine, il servizio Dataproc Metastore esegue il rollback al suo stato integro precedente.

Le seguenti istruzioni mostrano come aggiornare un servizio Dataproc Metastore.

Console

  1. Nella console Google Cloud , apri la pagina Dataproc Metastore:

    Apri Dataproc Metastore

  2. Nella pagina Dataproc Metastore, fai clic sul nome del servizio che vuoi aggiornare.

    Viene visualizzata la pagina Dettagli del servizio.

    Pagina dei dettagli del servizio
    La pagina dei dettagli del servizio Dataproc Metastore

  3. Nella scheda Configurazione, fai clic su Modifica.

    Viene visualizzata la pagina Modifica servizio.

  4. Scegli i valori che vuoi aggiornare per il tuo servizio.

  5. Fai clic su Invia.

    Torna alla pagina Dataproc Metastore e verifica che il servizio sia stato aggiornato correttamente.

Interfaccia a riga di comando gcloud

  1. Per aggiornare un servizio, esegui il seguente comando gcloud metastore services update:

    gcloud metastore services update SERVICE \
    --location=LOCATION \
    --port=PORT \
    --tier=TIER \
    --maintenance-window-day=MAINTENANCE_WINDOW_DAY \
    --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR \
    --kerberos_principal=KERBEROS_PRINCIPAL \
    --keytab=KEYTAB \
    --krb5-config=KRB5_CONFIG \
    --update-hive-metastore-configs-from-file=[KEY=VALUE, ...] \
    --clear-hive-metastore-configs \
    --remove-hive-metastore-configs=[KEY, ...] \
    --update-labels=[KEY=VALUE, ...] \
    --clear-labels \
    --remove-labels=[KEY, ...]

    Sostituisci quanto segue:

    • SERVICE: il nome del servizio Dataproc Metastore.
    • LOCATION: la Google Cloud regione in cui si trova il servizio Dataproc Metastore.
    • PORT: (facoltativo) La porta TCP dell'interfaccia Thrift che utilizzi con il servizio Dataproc Metastore.
    • TIER: (facoltativo) La capacità del livello del servizio Dataproc Metastore.
    • MAINTENANCE_WINDOW_DAY: (Facoltativo) Il giorno della settimana in cui inizia la finestra di servizio.
    • MAINTENANCE_WINDOW_HOUR: (Facoltativo) L'ora del giorno in cui inizia la finestra di servizio.
    • KERBEROS_PRINCIPAL: (facoltativo) un'entità Kerberos che esiste sia nel file keytab sia nel KDC. Un'entità tipica ha la forma"primary/instance@REALM", ma non esiste un formato esatto.
    • KEYTAB: (facoltativo) Un file keytab Kerberos utilizzato per autenticare un'entità servizio con un centro di distribuzione delle chiavi Kerberos.
    • KRB5_CONFIG: (facoltativo) Il file krb5.config specifica le informazioni sul KDC e sul realm Kerberos, tra cui le posizioni dei KDC e i valori predefiniti per il realm e le applicazioni Kerberos.
    • [KEY, ...]: (Facoltativo) le configurazioni del metastore Hive che vuoi aggiornare. Se in questo campo esiste una variabile, il relativo valore viene aggiornato. In caso contrario, viene creata una nuova variabile. Se questo flag è impostato, anche -clear-hive-metastore-configs viene impostato automaticamente.
    • [KEY, ...]: (Facoltativo) Le configurazioni del metastore Hive che vuoi rimuovere.
    • [KEY=VALUE, ...]: (facoltativo) le etichette o le configurazioni di coppie chiave-valore di Hive Metastore che vuoi aggiornare.
    • [KEY, ...]: (facoltativo) le etichette o le configurazioni di coppie chiave-valore di Hive Metastore che vuoi rimuovere.

  2. Verifica che l'aggiornamento sia riuscito.

REST

Segui le istruzioni dell'API per aggiornare un servizio utilizzando Explorer API.

Aggiorna la configurazione del warehouse Hive Metastore

Se la directory del warehouse Hive si trova su Cloud Storage, devi impostare un override della configurazione di Metastore. Questo override imposta il data warehouse specifico come directory del data warehouse predefinita per Dataproc Metastore

Prima di impostare questo override, assicurati che il servizio Dataproc Metastore disponga delle autorizzazioni di lettura e scrittura degli oggetti per accedere alla directory del warehouse. Per maggiori informazioni, consulta la sezione Directory del warehouse Hive.

Le seguenti istruzioni mostrano come aggiornare un override della configurazione di Hive Metastore.

Console

  1. Nella console Google Cloud , apri la pagina Dataproc Metastore:

    Apri Dataproc Metastore

  2. Nella pagina Dataproc Metastore, fai clic sul nome del servizio che vuoi aggiornare.

    Viene visualizzata la pagina Dettagli del servizio.

  3. Nella scheda Configurazione, fai clic su Modifica.

    Viene visualizzata la pagina Modifica servizio.

  4. In Override di configurazione metastore, inserisci quanto segue:

    • Chiave: inserisci il seguente valore: hive.metastore.warehouse.dir.
    • Valore: la posizione di Cloud Storage della directory del warehouse. Ad esempio: gs://my-bucket/path/to/location.

  5. Fai clic su Invia.

    Torna alla pagina Dataproc Metastore e verifica che il servizio sia stato aggiornato correttamente.

gcloud

  1. Per aggiornare un servizio, esegui il seguente comando gcloud metastore services update:

    gcloud metastore services update SERVICE \
    --location=LOCATION \
    --update-hive-metastore-configs="hive.metastore.warehouse.dir=CUSTOMER_DIR"

    Sostituisci quanto segue:

    • SERVICE: il nome del servizio Dataproc Metastore.
    • LOCATION: la Google Cloud regione in cui si trova il servizio Dataproc Metastore.
    • CUSTOMER_DIR: la posizione Cloud Storage della directory del magazzino. Ad esempio: gs://my-bucket/path/to/location

  2. Verifica che l'aggiornamento sia riuscito.

Passaggi successivi