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 località del servizio.
Sedi disponibili
I servizi Data Connect possono essere creati nelle seguenti regioni.
- 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
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)
Gestisci utenti
Data Connect fornisce strumenti per gestire l'accesso degli utenti che seguono il principio del privilegio minimo (concedere a ogni account utente o di servizio le autorizzazioni minime necessarie per supportare le funzionalità necessarie) e il concetto di controllo degli accessi basato sui ruoli (RBAC) (con ruoli predefiniti per gestire le autorizzazioni dei 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.
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. Leggi maggiori informazioni in:
- 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 abilitano i flussi di lavoro dell'interfaccia a riga di comando di Firebase per consentirti di gestire i tuoi progetti Data Connect.
Comando CLI, altro flusso di lavoro | Ruoli obbligatori |
---|---|
firebase init dataconnect
|
|
firebase deploy -–only dataconnect
|
|
firebase dataconnect:sql:diff
|
|
firebase dataconnect:sql:migrate |
|
firebase dataconnect:sql:grant
|
|
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, è previsto 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 relativa a 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 gratuita
Le seguenti funzionalità di Cloud SQL per PostgreSQL non sono supportate nella prova gratuita:
- Versioni di PostgreSQL diverse da 15.x
- Utilizzo di istanze Cloud SQL per PostgreSQL esistenti
- Livello 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.
- Arresta e riavvia le istanze Cloud SQL
- Creare ed eliminare database Cloud SQL (all'interno delle istanze)
- Avvia le istanze di database PostgreSQL con i flag e utilizza una serie di estensioni
- Monitora le prestazioni con le funzionalità di osservabilità di Cloud SQL nella console Google Cloud
- 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 abilitare 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 writer, esegui questo comando nell'interfaccia a riga di comando:
firebase dataconnect:sql:grant --role writer
Per maggiori dettagli, consulta la guida di riferimento della CLI.