Gestire i servizi e i database Data Connect

Nota: Firebase Data Connect è in Anteprima pubblica. Data Connect sarà soggetto ai "Termini delle offerte pre-GA" nella sezione Termini specifici dei servizi dei Termini di servizio della piattaforma Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

I progetti Data Connect sono costituiti da due elementi principali dell'infrastruttura:

• Una o più istanze di servizio Data Connect
• Una o più istanze Cloud SQL per PostgreSQL

Questa guida illustra come configurare e gestire le istanze di servizio Data Connect e come gestire le istanze Cloud SQL associate.

Configura le regioni per Firebase Data Connect

I progetti che utilizzano Data Connect richiedono un'impostazione di geolocalizzazione.

Quando crei una nuova istanza di servizio Data Connect, ti viene chiesto di selezionare la posizione del servizio.

Nota: le località dei servizi Data Connect non influiscono sulle opzioni per le località necessarie per altri prodotti Firebase che potresti avere nel tuo progetto, come le località predefinite delle risorse Google Cloud per Cloud Firestore.

Sedi disponibili

I servizi Data Connect possono essere creati nelle seguenti regioni.

Nota: il provisioning delle istanze Cloud SQL per PostgreSQL deve essere eseguito nella stessa posizione dell'istanza Data Connect associata.

• asia-east1
• asia-east2
• asia-northeast1
• asia-northeast2
• asia-northeast3
• asia-south1
• asia-southeast1
• asia-southeast2
• australia-southeast1
• australia-southeast2
• europe-central2
• europe-north1
• europe-southwest1
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• europe-west8
• europe-west9
• me-west1
• northamerica-northeast1
• northamerica-northeast2
• southamerica-east1
• southamerica-west1
• us-central1
• us-east1
• us-east4
• us-south1
• us-west1
• us-west2
• us-west3
• us-west4

L'integrazione di Vertex AI di

Data Connect non è supportata per le istanze Cloud SQL per PostgreSQL di cui è stato eseguito il deployment in:

• asia-northeast2
• asia-southeast2
• australia-southeast2
• northamerica-northeast2
• southamerica-west1
• us-west2
• us-west3

Gestire le istanze di servizio Data Connect

Creare servizi

Per creare un nuovo servizio, utilizza la console Firebase o esegui l'inizializzazione del progetto locale utilizzando l'interfaccia a riga di comando Firebase. Questi flussi di lavoro creano un nuovo servizioData Connect.

Questi flussi ti guidano anche in:

• Esegui il provisioning di una nuova istanza Cloud SQL (livello senza costi)
• Collegamento di un'istanza Cloud SQL esistente a Data Connect (piano Blaze)

Nota: il provisioning delle istanze Cloud SQL per PostgreSQL deve essere eseguito nella stessa posizione dell'istanza Data Connect associata. Se la tua applicazione richiede istanze Cloud SQL in più regioni, la FirebaseCLI può aiutarti a eseguire il deployment dello stesso schema, delle stesse query e delle stesse mutazioni nei numerosi servizi di connessione ai dati di ogni regione.

Gestisci utenti

Data Connect fornisce strumenti per gestire l'accesso degli utenti che rispettano il principio del privilegio minimo (concede a ogni utente o account di servizio le autorizzazioni minime necessarie per supportare le funzionalità necessarie) e il concetto di controllo degli accessi basato su ruoli (RBAC) (con ruoli predefiniti per gestire le autorizzazioni del database, semplificando la gestione della sicurezza).

Per aggiungere membri del progetto come utenti che possono modificare le istanze Data Connect nel progetto, utilizza la console Firebase per selezionare i ruoli utente predefiniti appropriati.

Nota: i servizi Data Connect e Cloud SQL per PostgreSQL sono componenti distinti del progetto Data Connect. Amministra ogni componente separatamente. Ad esempio, potresti aggiungere utenti Data Connect con autorizzazioni per eliminare gli schemi, ma ciò non gli consentirebbe di eseguirebackup di un database PostgreSQL.

Questi ruoli concedono autorizzazioni utilizzando Identity and Access Management (IAM). Un ruolo è una raccolta di autorizzazioni. Quando assegni un ruolo a un membro del progetto, gli concedi tutte le autorizzazioni incluse nel ruolo. Scopri di più in:

• La panoramica dei ruoli IAM di Firebase
• L'elenco dettagliato dei ruoli Data Connect

Scegli i ruoli per abilitare flussi di lavoro specifici

I ruoli IAM consentono ai flussi di lavoro della CLI Firebase di gestire i progetti Data Connect.

Comando CLI, altro flusso di lavoro	Ruoli richiesti
firebase init dataconnect	Nessuna autorizzazione (se non viene collegata un'istanza Cloud SQL) roles/cloudsql.admin (quando viene creata un'istanza Cloud SQL)
firebase deploy -–only dataconnect	firebasedataconnect.connectors.* firebasedataconnect.services.* firebasedataconnect.schemas.* roles/cloudsql.admin
firebase dataconnect:sql:diff	firebasedataconnect.services.* firebasedataconnect.schemas.*
firebase dataconnect:sql:migrate	ruoli/cloudsql.admin nell'istanza Cloud SQL di destinazione
firebase dataconnect:sql:grant	ruoli/cloudsql.admin nell'istanza Cloud SQL di destinazione

Monitorare le prestazioni del servizio Data Connect

Informazioni sulle prestazioni dei servizi

Le prestazioni sia del servizio Data Connect sia del servizio Cloud SQL per PostgreSQL possono influire sulla tua esperienza durante l'anteprima.

• Per il servizio Data Connect, esiste un limite di 1200 richieste GraphQL e di connettori al minuto, che influisce sulla frequenza con cui puoi chiamare ed eseguire query e mutazioni.
• Per il servizio Cloud SQL per PostgreSQL, consulta le indicazioni generali nella documentazione su quote e limiti.

Monitorare le prestazioni, l'utilizzo e la fatturazione dei servizi

Puoi monitorare richieste, errori e tassi di operazioni, sia a livello globale che per operazione, nella console Firebase.

Gestire le istanze Cloud SQL

Limitazioni della prova senza costi

Le seguenti funzionalità di Cloud SQL per PostgreSQL non sono supportate nella prova senza costi:

• Versioni di PostgreSQL diverse da 15.x
• Utilizzo di istanze Cloud SQL per PostgreSQL esistenti
• Livello di macchina diverso da db-f1-micro
• Modifica delle risorse dell'istanza, ad esempio spazio di archiviazione, memoria e CPU
• Repliche di lettura
• Indirizzo IP dell'istanza privata
• Alta disponibilità (multizona); sono supportate solo istanze a zona singola
• Versione Enterprise Plus
• Backup automatici
• Aumento automatico dello spazio di archiviazione.

Amministra le istanze Cloud SQL

In generale, puoi gestire le tue istanze Cloud SQL utilizzando la console Google Cloud per eseguire i seguenti flussi di lavoro.

Nota: i servizi Data Connect e Cloud SQL per PostgreSQL sono componenti distinti del progetto Data Connect. Amministra ogni componente separatamente. Ad esempio, potresti aggiungere utenti Cloud SQL con autorizzazioni per gestire le attività amministrative di PostgreSQL, come il monitoraggio delle prestazioni e i backup, ma ciò non gli conferirebbe la possibilità di modificare le istanze Data Connect.

• Arresta e riavvia le istanze Cloud SQL
• Creare ed eliminare database Cloud SQL (all'interno delle istanze)
• Avvia le istanze di database PostgreSQL con flag e utilizza una varietà di estensioni
• Monitora il rendimento con le funzionalità di osservabilità di Cloud SQL nella Google Cloud console
• Gestisci l'accesso e la sicurezza di Cloud SQL con funzionalità come IAM, Secret Manager, crittografia dei dati e proxy di autenticazione
• Aggiungere, eliminare e amministrare gli utenti Cloud SQL.

Per questi e altri flussi di lavoro, consulta la documentazione di Cloud SQL per PostgreSQL.

Concedi i ruoli utente PostgreSQL utilizzando gli strumenti Firebase CLI e Google Cloud

Data Connect fornisce strumenti per gestire l'accesso degli utenti che rispettano il principio del privilegio minimo (concede a ogni utente o account di servizio le autorizzazioni minime necessarie per supportare le funzionalità necessarie) e il concetto di controllo degli accessi basato su ruoli (RBAC) (con ruoli predefiniti per gestire le autorizzazioni del database, semplificando la gestione della sicurezza).

In alcuni casi, potresti volerti connettere direttamente al database Cloud SQL gestito da Data Connect tramite un client SQL a tua scelta utilizzando, ad esempio, Cloud Run, Cloud Functions o GKE.

Per attivare queste connessioni, devi concedere le autorizzazioni SQL:

• Assegna il ruolo IAM roles/cloudsql.client all'account utente o di servizio che deve connettersi all'istanza dalla console Google Cloud o utilizzando gcloud CLI
• Concedi il ruolo PostgreSQL necessario utilizzando la CLI Firebase

Assegna il ruolo IAM Cloud SQL

Per informazioni su come utilizzare Cloud SQL per PostgreSQL per assegnare il ruolo IAM roles/cloudsql.client, consulta Ruoli e autorizzazioni.

Concedi i ruoli PostgreSQL

Utilizzando la CLI Firebase, puoi concedere ruoli PostgreSQL predefiniti agli utenti o agli account di servizio associati al tuo progetto con il comando firebase dataconnect:sql:grant.

Ad esempio, per concedere il ruolo di autore, esegui questo comando nella CLI:

firebase dataconnect:sql:grant --role writer

Per maggiori dettagli, consulta la guida di riferimento della CLI.