Crea un database Firestore utilizzando una libreria client server
Questa guida rapida mostra come configurare Firestore, aggiungere dati e leggere utilizzando il client server C#, Go, Java, Node.js, PHP, Python o Ruby libreria.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Crea un database Firestore in modalità Native
Se si tratta di un nuovo progetto, devi creare un database Firestore in esecuzione in un'istanza Compute Engine.
Dalla schermata Seleziona un servizio di database, scegli Firestore in modalità Native.
Seleziona una località per il tuo Firestore
Questa impostazione di geolocalizzazione corrisponde a quella del progetto località Google Cloud Platform Cloud. Tieni presente che questa località verrà utilizzata per i servizi Google Cloud nel progetto che richiede l'impostazione di una località, in particolare, il valore predefinito del bucket Cloud Storage e App Engine (che richiesta se utilizzi Cloud Scheduler).
Fai clic su Crea database.
Quando crei un progetto Firestore, abilita anche l'API nella Gestore API Cloud.
Configura l'autenticazione
Per eseguire la libreria client, devi prima configurare autenticazione creando un account di servizio e impostando una variabile di ambiente.
Fornisci le credenziali di autenticazione al codice dell'applicazione impostando la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS
. Questa variabile si applica solo alla sessione di shell attuale. Se vuoi che la variabile venga applicata a future sessioni shell, impostala nel file di avvio della shell, ad esempio nel file ~/.bashrc
o ~/.profile
.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Sostituisci KEY_PATH
con il percorso del file JSON che contiene le tue credenziali.
Ad esempio:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
Per PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Sostituisci KEY_PATH
con il percorso del file JSON che contiene le tue credenziali.
Ad esempio:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
Per il prompt dei comandi:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
Sostituisci KEY_PATH
con il percorso del file JSON che contiene le tue credenziali.
Aggiungere la libreria client server all'app
Aggiungi le dipendenze e le librerie client necessarie alla tua app.
Java
Aggiungi la libreria Java di Firestore alla tua app:
-
Utilizzo di Maven:
<dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.43.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-firestore</artifactId> </dependency>
- Se utilizzi Gradle o esegui la configurazione senza BOM, consulta File README del client Firestore per Java.
-
Con un IDE:
Se utilizzi VS Code, IntelliJ o Eclipse, puoi aggiungere librerie client al tuo progetto utilizzando questi plug-in IDE:
I plug-in offrono funzionalità aggiuntive, come le chiavi per gli account di servizio. Fai riferimento alla documentazione di ciascun plug-in documentazione per i dettagli.
Python
Aggiungi la libreria Python di Firestore alla tua app:
pip install --upgrade google-cloud-firestore
Node.js
Aggiungi la libreria Node.js di Firestore alla tua app:
npm install --save @google-cloud/firestore
Vai
Installa la libreria Firestore Go:
go get cloud.google.com/go/firestore
Aggiungi la libreria Firestore Go alla tua app:
import "cloud.google.com/go/firestore"
PHP
- Installa e abilita l'estensione gRPC per PHP, che dovrai usare la libreria client.
-
Aggiungi la libreria PHP di Firestore alla tua app:
composer require google/cloud-firestore
C#
-
Aggiungi la libreria C# di Firestore alla tua app nel file
.csproj
:<ItemGroup> <PackageReference Include="Google.Cloud.Firestore" Version="1.1.0-beta01" /> </ItemGroup>
-
Aggiungi quanto segue al file
Program.cs
:using Google.Cloud.Firestore;
Ruby
-
Aggiungi la libreria Ruby di Firestore alla tua app in
Gemfile
:gem "google-cloud-firestore"
-
Installa le dipendenze da
Gemfile
utilizzando:bundle install
Inizializza Firestore
Inizializza un'istanza di Firestore:
Java
import com.google.cloud.firestore.Firestore; import com.google.cloud.firestore.FirestoreOptions;
FirestoreOptions firestoreOptions = FirestoreOptions.getDefaultInstance().toBuilder() .setProjectId(projectId) .setCredentials(GoogleCredentials.getApplicationDefault()) .build(); Firestore db = firestoreOptions.getService();
Python
from google.cloud import firestore # The `project` parameter is optional and represents which project the client # will act on behalf of. If not supplied, the client falls back to the default # project inferred from the environment. db = firestore.Client(project="my-project-id")
Python
(Async)
from google.cloud import firestore # The `project` parameter is optional and represents which project the client # will act on behalf of. If not supplied, the client falls back to the default # project inferred from the environment. db = firestore.AsyncClient(project="my-project-id")
Node.js
const Firestore = require('@google-cloud/firestore'); const db = new Firestore({ projectId: 'YOUR_PROJECT_ID', keyFilename: '/path/to/keyfile.json', });
Vai
import ( "context" "flag" "fmt" "log" "google.golang.org/api/iterator" "cloud.google.com/go/firestore" ) func createClient(ctx context.Context) *firestore.Client { // Sets your Google Cloud Platform project ID. projectID := "YOUR_PROJECT_ID" client, err := firestore.NewClient(ctx, projectID) if err != nil { log.Fatalf("Failed to create client: %v", err) } // Close client when done with // defer client.Close() return client }
PHP
use Google\Cloud\Firestore\FirestoreClient; /** * Initialize Cloud Firestore with default project ID. */ function setup_client_create(string $projectId = null) { // Create the Cloud Firestore client if (empty($projectId)) { // The `projectId` parameter is optional and represents which project the // client will act on behalf of. If not supplied, the client falls back to // the default project inferred from the environment. $db = new FirestoreClient(); printf('Created Cloud Firestore client with default project ID.' . PHP_EOL); } else { $db = new FirestoreClient([ 'projectId' => $projectId, ]); printf('Created Cloud Firestore client with project ID: %s' . PHP_EOL, $projectId); } }
C#
Ruby
require "google/cloud/firestore" # The `project_id` parameter is optional and represents which project the # client will act on behalf of. If not supplied, the client falls back to the # default project inferred from the environment. firestore = Google::Cloud::Firestore.new project_id: project_id puts "Created Cloud Firestore client with given project ID."
Aggiungi dati
Firestore archivia i dati in Documenti, che sono archiviati in Raccolte. Firestore crea raccolte e documenti in modo implicito la prima volta che aggiungi dati al documento. Non è necessario specificare creare raccolte o documenti.
Crea una nuova raccolta e un nuovo documento utilizzando il seguente codice di esempio.
Java
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
(Async)
Node.js
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ora aggiungi un altro documento alla raccolta users
. Tieni presente che questo documento
Includa una coppia chiave-valore (secondo nome) che non compare nella prima
documento. I documenti di una raccolta possono contenere diversi insiemi di informazioni.
Java
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
(Async)
Node.js
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Lettura di dati
Per verificare rapidamente di aver aggiunto dati a Firestore, utilizza i dati visualizzatore nel Console Firebase.
Puoi anche utilizzare il metodo get
per recuperare l'intera collezione.
Java
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
(Async)
Node.js
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione su Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Approfondisci le tue conoscenze sui seguenti argomenti:
- Modello dei dati: scopri di più su come vengono strutturati in Firestore, che includono dati gerarchici e sottoraccolte.
- Aggiungi dati: scopri di più su come creare e aggiornare i dati in Firestore.
- Recupera i dati: scopri di più su come recuperarli e i dati di Google Cloud.
- Esecuzione di query semplici e composte: scopri come eseguire query semplici e composte.
- Query relative a un ordine e a una limitazione: scopri come effettuare un ordine e limitare i dati restituiti dalle query.