Crea un database Firestore utilizzando una libreria client server
Questa guida rapida mostra come configurare Firestore, aggiungere e leggere dati utilizzando la libreria client server C#, Go, Java, Node.js, PHP, Python o Ruby.
Prima di iniziare
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
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'istanza del database Firestore.
Nella schermata Seleziona un servizio di database, scegli Firestore in modalità nativa.
Seleziona una posizione per Firestore.
Se non riesci a selezionare una località, significa che la "posizione per le risorse predefinite" del progetto è già stata impostata. Google Cloud Alcune risorse del tuo progetto (come l'istanza Firestore predefinita) condividono una dipendenza di località comune e la loro località può essere impostata durante la creazione del progetto o durante la configurazione di un altro servizio che condivide questa dipendenza di località.
Fai clic su Crea database.
Quando crei un progetto Firestore, viene abilitata anche l'API in Cloud API Manager.
Configura l'autenticazione
Per eseguire la libreria client, devi prima configurare l'autenticazione creando un account di servizio e impostando una variabile di ambiente.
Provide authentication credentials to your application code by setting the
environment variable GOOGLE_APPLICATION_CREDENTIALS
. This
variable applies only to your current shell session. If you want the variable
to apply to future shell sessions, set the variable in your shell startup file,
for example in the ~/.bashrc
or ~/.profile
file.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Replace KEY_PATH
with the path of the JSON file that contains your credentials.
For example:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
For PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Replace KEY_PATH
with the path of the JSON file that contains your credentials.
For example:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
For command prompt:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
Replace KEY_PATH
with the path of the JSON file that contains your credentials.
Aggiungere la libreria client server alla tua 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.63.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 la configurazione senza BOM, consulta il file README del client Firestore per Java.
-
Utilizzo di un IDE:
Se utilizzi VS Code, IntelliJ o Eclipse, puoi aggiungere le librerie client al tuo progetto utilizzando questi plug-in IDE:
I plug-in forniscono funzionalità aggiuntive, come la gestione delle chiavi per i service account. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.
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 Go di Firestore:
go get cloud.google.com/go/firestore
Aggiungi la libreria Firestore Go alla tua app:
import "cloud.google.com/go/firestore"
PHP
- Installa e attiva l'estensione gRPC per PHP, che ti servirà per utilizzare 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 tuo 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 in modalità Native
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 vengono archiviati in raccolte. Firestore crea raccolte e documenti in modo implicito la prima volta che aggiungi dati al documento. Non è necessario creare esplicitamente raccolte o documenti.
Crea una nuova raccolta e un nuovo documento utilizzando il seguente codice di esempio.
Java
Per eseguire l'autenticazione in 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 in 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 in 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 in 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 in 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 in 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 in 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
include una coppia chiave-valore (secondo nome) che non è presente nel primo
documento. I documenti di una raccolta possono contenere diversi set di informazioni.
Java
Per eseguire l'autenticazione in 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 in 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 in 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 in 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 in 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 in 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 in 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 il visualizzatore di dati nella console Firebase.
Puoi anche utilizzare il metodo get
per recuperare l'intera raccolta.
Java
Per eseguire l'autenticazione in 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 in 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 in 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 in 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 in 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 in 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 in 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 con i seguenti argomenti:
- Modello di dati: scopri di più su come sono strutturati i dati in Firestore, inclusi dati gerarchici e subcollezioni.
- Aggiungere dati: scopri di più sulla creazione e sull'aggiornamento dei dati in Firestore.
- Recupera dati: scopri di più su come recuperare i dati.
- Eseguire query semplici e composte: scopri come eseguire query semplici e composte.
- Query di ordinamento e limitazione: scopri come ordinare e limitare i dati restituiti dalle query.