Questa guida rapida mostra come configurare Cloud Firestore, aggiungere dati e visualizzare i dati appena aggiunti nella Console Firebase.
Creare un database Cloud Firestore
Se non l'hai ancora fatto, crea un progetto Firebase: nella console Firebase, fai clic su Aggiungi progetto, poi segui le istruzioni sullo schermo per creare un progetto Firebase o per aggiungere i servizi Firebase a un progetto Google Cloud esistente.
Apri il progetto nella console Firebase. Nel riquadro a sinistra, espandi Compilazione e seleziona Database Firestore.
Fai clic su Crea database.
Seleziona una località per il tuo database.
Se non riesci a selezionare una località, significa che la "località per le risorse Google Cloud predefinite" del progetto è già stata impostata. Alcune risorse del progetto (ad esempio l'istanza Cloud Firestore predefinita) condividono una dipendenza dalla località comune e la loro posizione può essere impostata durante la creazione del progetto o durante la configurazione di un altro servizio che condivide questa dipendenza dalla località.
Seleziona una modalità di avvio per Cloud Firestore Security Rules:
- Modalità di test
Ottima per iniziare a utilizzare le librerie client mobile e web, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di leggere la sezione Proteggere i dati.
Per iniziare a utilizzare il web, le piattaforme Apple o l'SDK Android, seleziona la modalità di test.
- Modalità di blocco
Rifiuta tutte le letture e le scritture dai client web e mobile. I tuoi server di applicazioni autenticati (C#, Go, Java, Node.js, PHP, Python o Ruby) possono comunque accedere al tuo database.
Per iniziare a utilizzare la libreria client server di C#, Go, Java, Node.js, PHP, Python o Ruby, seleziona la modalità bloccata.
Il set iniziale di Cloud Firestore Security Rules verrà applicato al database Cloud Firestore predefinito. Se crei più database per il tuo progetto, puoi eseguire il deployment di Cloud Firestore Security Rules per ogni database.
Fai clic su Crea.
Se attivi Cloud Firestore, viene attivata anche l'API in Cloud API Manager.
Configurazione dell'ambiente di sviluppo
Aggiungi le dipendenze e le librerie client necessarie alla tua app.
Web
- Segui le istruzioni per aggiungere Firebase alla tua app web.
- Aggiungi le librerie Firebase e Cloud Firestore alla tua app:
L'SDK Cloud Firestore è disponibile anche come pacchetto npm.<script src="https://www.gstatic.com/firebasejs/11.0.2/firebase-app-compat.js"></script> <script src="https://www.gstatic.com/firebasejs/11.0.2/firebase-firestore-compat.js"></script>
Dovrai richiedere manualmente sia Firebase che Cloud Firestore.npm install firebase@11.0.2 --save
import firebase from "firebase/compat/app"; // Required for side-effects import "firebase/firestore";
Web
- Segui le istruzioni per aggiungere Firebase alla tua app web.
-
L'SDK Cloud Firestore è disponibile come pacchetto npm.
Dovrai importare sia Firebase sia Cloud Firestore.npm install firebase@11.0.2 --save
import { initializeApp } from "firebase/app"; import { getFirestore } from "firebase/firestore";
iOS+
Segui le istruzioni per aggiungere Firebase alla tua app Apple.
Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.
- In Xcode, con il progetto dell'app aperto, vai a File > Pacchetti Swift > Aggiungi dipendenza pacchetto.
- Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
- Scegli la libreria Firestore.
- Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
https://github.com/firebase/firebase-ios-sdk
Android
- Segui le istruzioni per aggiungere Firebase alla tua app Android.
- Utilizzando la
disposta base di Firebase per Android,
dichiara la dipendenza per la libreria Cloud Firestore per Android nel
file Gradle del modulo (a livello di app)
(di solito
app/build.gradle.kts
oapp/build.gradle
).dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.7.0")) // Declare the dependency for the Cloud Firestore library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-firestore") }
Con la distinta base di Firebase Android, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.
(Alternativa) Dichiara le dipendenze delle librerie Firebase senza utilizzare il BoM
Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga di dipendenza.
Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni.
dependencies { // Declare the dependency for the Cloud Firestore library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-firestore:25.1.1") }
Cerchi un modulo della libreria specifico per Kotlin? A partire dalla release di ottobre 2023, sia gli sviluppatori Kotlin che quelli Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le domande frequenti su questa iniziativa).
Dart
- Se non l'hai ancora fatto, configura e inizializza Firebase nella tua app Flutter.
- Dalla directory principale del progetto Flutter, esegui il seguente comando per installare il plug-in:
flutter pub add cloud_firestore
- Al termine, ricostruisci l'applicazione Flutter:
flutter run
- Facoltativo: migliora i tempi di compilazione di iOS e macOS includendo il
framework precompilato.
Al momento, l'SDK Firestore per iOS dipende da codice la cui compilazione in Xcode può richiedere più di 5 minuti. Per ridurre in modo significativo i tempi di compilazione, puoi utilizzare una versione precompilata aggiungendo questa riga al blocco
target 'Runner' do
nel Podfile:target 'Runner' do use_frameworks! use_modular_headers! pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => 'IOS_SDK_VERSION' flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) target 'RunnerTests' do inherit! :search_paths end end
Sostituisci IOS_SDK_VERSION con la versione dell'SDK Firebase per iOS specificata nel file
firebase_sdk_version.rb
difirebase_core
. Se non utilizzi la versione più recente difirebase_core
, cerca questo file nella cache del pacchetto Pub locale (di solito~/.pub-cache
).Inoltre, assicurati di aver eseguito l'upgrade di CocoaPods alla versione 1.9.1 o superiore:
gem install cocoapods
Per maggiori informazioni, consulta il problema su GitHub.
Java
- Aggiungi l'SDK Firebase Admin alla tua app:
-
Utilizzo di Gradle:
compile 'com.google.firebase:firebase-admin:1.32.0'
-
Utilizzo di Maven:
<dependency> <groupId>com.google.firebase</groupId> <artifactId>firebase-admin</artifactId> <version>1.32.0</version> </dependency>
-
Utilizzo di Gradle:
- Segui le istruzioni riportate di seguito per inizializzare Cloud Firestore con le credenziali appropriate nel tuo ambiente.
Python
- Aggiungi l'SDK Firebase Admin alla tua app Python:
pip install --upgrade firebase-admin
- Segui le istruzioni riportate di seguito per inizializzare Cloud Firestore con le credenziali appropriate nel tuo ambiente.
C++
- Segui le istruzioni per aggiungere Firebase al tuo progetto C++.
- Interfaccia C++ per Android.
- Dipendenze Gradle. Aggiungi quanto segue al file Gradle
(a livello di app) del modulo (di solito
app/build.gradle
):android.defaultConfig.externalNativeBuild.cmake { arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir" } apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle" firebaseCpp.dependencies { // earlier entries auth firestore }
- Dipendenze binarie. Analogamente, il modo consigliato per ottenere
le dipendenze binarie è aggiungere quanto segue al tuo file
CMakeLists.txt
:add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL) set(firebase_libs firebase_auth firebase_firestore firebase_app) # Replace the target name below with the actual name of your target, # for example, "native-lib". target_link_libraries(${YOUR_TARGET_NAME_HERE} "${firebase_libs}")
- Per configurare l'integrazione per computer, consulta Aggiungi Firebase al tuo progetto C++.
Unity
- Segui le istruzioni per aggiungere Firebase al tuo progetto Unity.
- Utilizza l'interfaccia di Unity per configurare il progetto in modo da ridurre al minimo le build Android.
- L'opzione è disponibile in Impostazioni del giocatore > Android > Impostazioni di pubblicazione > Minimizza.
- Le opzioni possono variare in base alle versioni di Unity, quindi consulta la documentazione ufficiale di Unity e la guida alla debug di Firebase Unity Build.
-
Se, dopo aver attivato la minimizzazione, il numero di metodi a cui viene fatto riferimento supera ancora il limite, un'altra opzione è attivare
multidex
in:-
mainTemplate.gradle
se l'opzione Modello Gradle personalizzato in Impostazioni player è attivata -
In alternativa, il file
build.gradle
a livello di modulo, se utilizzi Android Studio per compilare il progetto esportato.
-
Devi ridurre al minimo la compilazione per evitare il messaggio Error while merging dex archives
.
Node.js
-
Aggiungi l'SDK Firebase Admin alla tua app:
npm install firebase-admin --save
- Segui le istruzioni riportate di seguito per inizializzare Cloud Firestore con le credenziali appropriate nel tuo ambiente.
Vai
- Aggiungi l'SDK Firebase Admin alla tua app Go:
go get firebase.google.com/go
- Segui le istruzioni riportate di seguito per inizializzare Cloud Firestore con le credenziali appropriate nel tuo ambiente.
PHP
-
Le librerie client server Cloud Firestore (Java, Node.js, Python, Go, PHP, C# e Ruby) utilizzano le Credenziali predefinite dell'applicazione Google per l'autenticazione.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
in modo che rimandi a un file della chiave dell'account di servizio JSON. Puoi creare un file di chiavi nella pagina Credenziali della console API.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- Nell'ambiente di produzione, non è necessario autenticarsi se esegui l'applicazione su App Engine o Compute Engine utilizzando lo stesso progetto utilizzato per Cloud Firestore. In caso contrario, configura un account di servizio.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
- Installa e attiva l'estensione gRPC per PHP, necessaria per utilizzare la libreria client.
-
Aggiungi la libreria PHP di Cloud Firestore alla tua app:
composer require google/cloud-firestore
C#
-
Le librerie client server Cloud Firestore (Java, Node.js, Python, Go, PHP, C# e Ruby) utilizzano le Credenziali predefinite dell'applicazione Google per l'autenticazione.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
in modo che rimandi a un file della chiave dell'account di servizio JSON. Puoi creare un file di chiavi nella pagina Credenziali della console API.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- Nell'ambiente di produzione, non è necessario autenticarsi se esegui l'applicazione su App Engine o Compute Engine utilizzando lo stesso progetto utilizzato per Cloud Firestore. In caso contrario, configura un account di servizio.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
-
Aggiungi la libreria C# di Cloud 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
-
Le librerie client server Cloud Firestore (Java, Node.js, Python, Go, PHP, C# e Ruby) utilizzano le Credenziali predefinite dell'applicazione Google per l'autenticazione.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
in modo che rimandi a un file della chiave dell'account di servizio JSON. Puoi creare un file di chiavi nella pagina Credenziali della console API.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- Nell'ambiente di produzione, non è necessario autenticarsi se esegui l'applicazione su App Engine o Compute Engine utilizzando lo stesso progetto utilizzato per Cloud Firestore. In caso contrario, configura un account di servizio.
-
Per eseguire l'autenticazione dall'ambiente di sviluppo, imposta la variabile di ambiente
-
Aggiungi la libreria Ruby di Cloud Firestore alla tua app in
Gemfile
:gem "google-cloud-firestore"
-
Installa le dipendenze dal tuo
Gemfile
utilizzando:bundle install
(Facoltativo) Crea un prototipo e testa con Firebase Local Emulator Suite
Per gli sviluppatori di app mobile, prima di parlare di come la tua app scrive e legge da Cloud Firestore, presentiamo un insieme di strumenti che puoi utilizzare per prototipare e testare la funzionalità di Cloud Firestore: Firebase Local Emulator Suite. Se stai provando diversi modelli di dati, ottimizzando le regole di sicurezza o cercando di trovare il modo più conveniente per interagire con il back-end, la possibilità di lavorare localmente senza implementare i servizi in produzione può essere un'ottima idea.
Un emulatore Cloud Firestore fa parte di Local Emulator Suite, che consente all'app di interagire con i contenuti e la configurazione del database emulati, nonché, facoltativamente, con le risorse del progetto emulate (funzioni, altri database e regole di sicurezza).
L'utilizzo dell'emulatore Cloud Firestore prevede solo pochi passaggi:
- Aggiungere una riga di codice alla configurazione di test dell'app per connettersi all'emulatore.
- Dalla directory principale del progetto locale, esegui
firebase emulators:start
. - Effettuare chiamate dal codice del prototipo dell'app utilizzando un SDK di piattaforma Cloud Firestore come di consueto.
È disponibile una procedura dettagliata che coinvolge Cloud Firestore e Cloud Functions. Consulta anche l'introduzione a Local Emulator Suite.
Inizializza Cloud Firestore
Inizializza un'istanza di Cloud Firestore:
Web
import { initializeApp } from "firebase/app"; import { getFirestore } from "firebase/firestore"; // TODO: Replace the following with your app's Firebase project configuration // See: https://support.google.com/firebase/answer/7015592 const firebaseConfig = { FIREBASE_CONFIGURATION }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Cloud Firestore and get a reference to the service const db = getFirestore(app);
Sostituisci FIREBASE_CONFIGURATION con il valore firebaseConfig
della tua app web.
Per mantenere i dati quando il dispositivo perde la connessione, consulta la documentazione su come abilitare i dati offline.
Web
import firebase from "firebase/app"; import "firebase/firestore"; // TODO: Replace the following with your app's Firebase project configuration // See: https://support.google.com/firebase/answer/7015592 const firebaseConfig = { FIREBASE_CONFIGURATION }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Cloud Firestore and get a reference to the service const db = firebase.firestore();
Sostituisci FIREBASE_CONFIGURATION con il valore firebaseConfig
della tua app web.
Per mantenere i dati quando il dispositivo perde la connessione, consulta la documentazione su come abilitare i dati offline.
Swift
import FirebaseCore import FirebaseFirestore
FirebaseApp.configure() let db = Firestore.firestore()
Objective-C
@import FirebaseCore; @import FirebaseFirestore; // Use Firebase library to configure APIs [FIRApp configure];
FIRFirestore *defaultFirestore = [FIRFirestore firestore];
Kotlin
// Access a Cloud Firestore instance from your Activity
val db = Firebase.firestore
Java
// Access a Cloud Firestore instance from your Activity
FirebaseFirestore db = FirebaseFirestore.getInstance();
Dart
db = FirebaseFirestore.instance;
Java
L'SDK Cloud Firestore viene inizializzato in modi diversi a seconda del tuo ambiente. Di seguito sono riportati i metodi più comuni. Per un riferimento completo, consulta Inizializzare l'SDK Admin.import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use the application default credentials GoogleCredentials credentials = GoogleCredentials.getApplicationDefault(); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .setProjectId(projectId) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
Per utilizzare l'SDK Firebase Admin sul tuo server, utilizza un account di servizio.
Vai a IAM e amministrazione > Account di servizio nella console Google Cloud. Genera una nuova chiave privata e salva il file JSON. Quindi, utilizza il file per inizializzare l'SDK:
import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use a service account InputStream serviceAccount = new FileInputStream("path/to/serviceAccount.json"); GoogleCredentials credentials = GoogleCredentials.fromStream(serviceAccount); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
Python
L'SDK Cloud Firestore viene inizializzato in modi diversi a seconda del tuo ambiente. Di seguito sono riportati i metodi più comuni. Per un riferimento completo, consulta Inizializzare l'SDK Admin.import firebase_admin from firebase_admin import firestore # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore.client()
Per inizializzare l'SDK puoi anche utilizzare una credenziale predefinita dell'applicazione esistente.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore.client()
Per utilizzare l'SDK Firebase Admin sul tuo server, utilizza un account di servizio.
Vai a IAM e amministrazione > Account di servizio nella console Google Cloud. Genera una nuova chiave privata e salva il file JSON. Quindi, utilizza il file per inizializzare l'SDK:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore.client()
Python
L'SDK Cloud Firestore viene inizializzato in modi diversi a seconda del tuo ambiente. Di seguito sono riportati i metodi più comuni. Per un riferimento completo, consulta Inizializzare l'SDK Admin.import firebase_admin from firebase_admin import firestore_async # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore_async.client()
Per inizializzare l'SDK puoi anche utilizzare una credenziale predefinita dell'applicazione esistente.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore_async.client()
Per utilizzare l'SDK Firebase Admin sul tuo server, utilizza un account di servizio.
Vai a IAM e amministrazione > Account di servizio nella console Google Cloud. Genera una nuova chiave privata e salva il file JSON. Quindi, utilizza il file per inizializzare l'SDK:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore_async.client()
C++
// Make sure the call to `Create()` happens some time before you call Firestore::GetInstance(). App::Create(); Firestore* db = Firestore::GetInstance();
Node.js
L'SDK Cloud Firestore viene inizializzato in modi diversi a seconda del tuo ambiente. Di seguito sono riportati i metodi più comuni. Per un riferimento completo, consulta Inizializzare l'SDK Admin.-
Eseguire l'inizializzazione il giorno Cloud Functions
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp(); const db = getFirestore();
-
Eseguire l'inizializzazione il giorno Google Cloud
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp({ credential: applicationDefault() }); const db = getFirestore();
-
Eseguire l'inizializzazione sul tuo server
Per utilizzare l'SDK Firebase Admin sul tuo server (o in qualsiasi altro ambiente Node.js), utilizza un account di servizio. Vai a IAM e amministrazione > Account di servizio nella console Google Cloud. Genera una nuova chiave privata e salva il file JSON. Quindi, utilizza il file per inizializzare l'SDK:
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
const serviceAccount = require('./path/to/serviceAccountKey.json'); initializeApp({ credential: cert(serviceAccount) }); const db = getFirestore();
Vai
L'SDK Cloud Firestore viene inizializzato in modi diversi a seconda del tuo ambiente. Di seguito sono riportati i metodi più comuni. Per un riferimento completo, consulta Inizializzare l'SDK Admin.import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use the application default credentials ctx := context.Background() conf := &firebase.Config{ProjectID: projectID} app, err := firebase.NewApp(ctx, conf) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
Per utilizzare l'SDK Firebase Admin sul tuo server, utilizza un account di servizio.
Vai a IAM e amministrazione > Account di servizio nella console Google Cloud. Genera una nuova chiave privata e salva il file JSON. Quindi, utilizza il file per inizializzare l'SDK:
import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use a service account ctx := context.Background() sa := option.WithCredentialsFile("path/to/serviceAccount.json") app, err := firebase.NewApp(ctx, nil, sa) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
PHP
PHP
Per saperne di più sull'installazione e sulla creazione di un client Cloud Firestore, consulta Librerie client Cloud Firestore.
Unity
using Firebase.Firestore; using Firebase.Extensions;
FirebaseFirestore db = FirebaseFirestore.DefaultInstance;
C#
C#
Per saperne di più sull'installazione e sulla creazione di un client Cloud Firestore, consulta Librerie client Cloud Firestore.
Ruby
Aggiungi dati
Cloud Firestore archivia i dati nei documenti, che sono archiviati nelle raccolte. Cloud 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 documento utilizzando il seguente codice di esempio.
Web
import { collection, addDoc } from "firebase/firestore"; try { const docRef = await addDoc(collection(db, "users"), { first: "Ada", last: "Lovelace", born: 1815 }); console.log("Document written with ID: ", docRef.id); } catch (e) { console.error("Error adding document: ", e); }
Web
db.collection("users").add({ first: "Ada", last: "Lovelace", born: 1815 }) .then((docRef) => { console.log("Document written with ID: ", docRef.id); }) .catch((error) => { console.error("Error adding document: ", error); });
Swift
// Add a new document with a generated ID do { let ref = try await db.collection("users").addDocument(data: [ "first": "Ada", "last": "Lovelace", "born": 1815 ]) print("Document added with ID: \(ref.documentID)") } catch { print("Error adding document: \(error)") }
Objective-C
// Add a new document with a generated ID __block FIRDocumentReference *ref = [[self.db collectionWithPath:@"users"] addDocumentWithData:@{ @"first": @"Ada", @"last": @"Lovelace", @"born": @1815 } completion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error adding document: %@", error); } else { NSLog(@"Document added with ID: %@", ref.documentID); } }];
Kotlin
// Create a new user with a first and last name val user = hashMapOf( "first" to "Ada", "last" to "Lovelace", "born" to 1815, ) // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener { documentReference -> Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}") } .addOnFailureListener { e -> Log.w(TAG, "Error adding document", e) }
Java
// Create a new user with a first and last name Map<String, Object> user = new HashMap<>(); user.put("first", "Ada"); user.put("last", "Lovelace"); user.put("born", 1815); // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener(new OnSuccessListener<DocumentReference>() { @Override public void onSuccess(DocumentReference documentReference) { Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId()); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "Error adding document", e); } });
Dart
// Create a new user with a first and last name final user = <String, dynamic>{ "first": "Ada", "last": "Lovelace", "born": 1815 }; // Add a new document with a generated ID db.collection("users").add(user).then((DocumentReference doc) => print('DocumentSnapshot added with ID: ${doc.id}'));
Java
Python
Python
C++
// Add a new document with a generated ID Future<DocumentReference> user_ref = db->Collection("users").Add({{"first", FieldValue::String("Ada")}, {"last", FieldValue::String("Lovelace")}, {"born", FieldValue::Integer(1815)}}); user_ref.OnCompletion([](const Future<DocumentReference>& future) { if (future.error() == Error::kErrorOk) { std::cout << "DocumentSnapshot added with ID: " << future.result()->id() << std::endl; } else { std::cout << "Error adding document: " << future.error_message() << std::endl; } });
Node.js
Vai
PHP
PHP
Per saperne di più sull'installazione e sulla creazione di un client Cloud Firestore, consulta Librerie client Cloud Firestore.
Unity
DocumentReference docRef = db.Collection("users").Document("alovelace"); Dictionary<string, object> user = new Dictionary<string, object> { { "First", "Ada" }, { "Last", "Lovelace" }, { "Born", 1815 }, }; docRef.SetAsync(user).ContinueWithOnMainThread(task => { Debug.Log("Added data to the alovelace document in the users collection."); });
C#
Ruby
Ora aggiungi un altro documento alla raccolta users
. Tieni presente che questo documento include una coppia chiave-valore (nome intermedio) che non compare nel primo documento. I documenti di una raccolta possono contenere diversi insiemi di informazioni.
Web
// Add a second document with a generated ID. import { addDoc, collection } from "firebase/firestore"; try { const docRef = await addDoc(collection(db, "users"), { first: "Alan", middle: "Mathison", last: "Turing", born: 1912 }); console.log("Document written with ID: ", docRef.id); } catch (e) { console.error("Error adding document: ", e); }
Web
// Add a second document with a generated ID. db.collection("users").add({ first: "Alan", middle: "Mathison", last: "Turing", born: 1912 }) .then((docRef) => { console.log("Document written with ID: ", docRef.id); }) .catch((error) => { console.error("Error adding document: ", error); });
Swift
// Add a second document with a generated ID. do { let ref = try await db.collection("users").addDocument(data: [ "first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912 ]) print("Document added with ID: \(ref.documentID)") } catch { print("Error adding document: \(error)") }
Objective-C
// Add a second document with a generated ID. __block FIRDocumentReference *ref = [[self.db collectionWithPath:@"users"] addDocumentWithData:@{ @"first": @"Alan", @"middle": @"Mathison", @"last": @"Turing", @"born": @1912 } completion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error adding document: %@", error); } else { NSLog(@"Document added with ID: %@", ref.documentID); } }];
Kotlin
// Create a new user with a first, middle, and last name val user = hashMapOf( "first" to "Alan", "middle" to "Mathison", "last" to "Turing", "born" to 1912, ) // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener { documentReference -> Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}") } .addOnFailureListener { e -> Log.w(TAG, "Error adding document", e) }
Java
// Create a new user with a first, middle, and last name Map<String, Object> user = new HashMap<>(); user.put("first", "Alan"); user.put("middle", "Mathison"); user.put("last", "Turing"); user.put("born", 1912); // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener(new OnSuccessListener<DocumentReference>() { @Override public void onSuccess(DocumentReference documentReference) { Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId()); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "Error adding document", e); } });
Dart
// Create a new user with a first and last name final user = <String, dynamic>{ "first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912 }; // Add a new document with a generated ID db.collection("users").add(user).then((DocumentReference doc) => print('DocumentSnapshot added with ID: ${doc.id}'));
Java
Python
Python
C++
db->Collection("users") .Add({{"first", FieldValue::String("Alan")}, {"middle", FieldValue::String("Mathison")}, {"last", FieldValue::String("Turing")}, {"born", FieldValue::Integer(1912)}}) .OnCompletion([](const Future<DocumentReference>& future) { if (future.error() == Error::kErrorOk) { std::cout << "DocumentSnapshot added with ID: " << future.result()->id() << std::endl; } else { std::cout << "Error adding document: " << future.error_message() << std::endl; } });
Node.js
Vai
PHP
PHP
Per saperne di più sull'installazione e sulla creazione di un client Cloud Firestore, consulta Librerie client Cloud Firestore.
Unity
DocumentReference docRef = db.Collection("users").Document("aturing"); Dictionary<string, object> user = new Dictionary<string, object> { { "First", "Alan" }, { "Middle", "Mathison" }, { "Last", "Turing" }, { "Born", 1912 } }; docRef.SetAsync(user).ContinueWithOnMainThread(task => { Debug.Log("Added data to the aturing document in the users collection."); });
C#
Ruby
Lettura di dati
Utilizza lo visualizzatore dei dati nella Console Firebase per verificare rapidamente di aver aggiunto dati a Cloud Firestore.
Puoi anche utilizzare il metodo "get" per recuperare l'intera raccolta.
Web
import { collection, getDocs } from "firebase/firestore"; const querySnapshot = await getDocs(collection(db, "users")); querySnapshot.forEach((doc) => { console.log(`${doc.id} => ${doc.data()}`); });
Web
db.collection("users").get().then((querySnapshot) => { querySnapshot.forEach((doc) => { console.log(`${doc.id} => ${doc.data()}`); }); });
Swift
do { let snapshot = try await db.collection("users").getDocuments() for document in snapshot.documents { print("\(document.documentID) => \(document.data())") } } catch { print("Error getting documents: \(error)") }
Objective-C
[[self.db collectionWithPath:@"users"] getDocumentsWithCompletion:^(FIRQuerySnapshot * _Nullable snapshot, NSError * _Nullable error) { if (error != nil) { NSLog(@"Error getting documents: %@", error); } else { for (FIRDocumentSnapshot *document in snapshot.documents) { NSLog(@"%@ => %@", document.documentID, document.data); } } }];
Kotlin
db.collection("users") .get() .addOnSuccessListener { result -> for (document in result) { Log.d(TAG, "${document.id} => ${document.data}") } } .addOnFailureListener { exception -> Log.w(TAG, "Error getting documents.", exception) }
Java
db.collection("users") .get() .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() { @Override public void onComplete(@NonNull Task<QuerySnapshot> task) { if (task.isSuccessful()) { for (QueryDocumentSnapshot document : task.getResult()) { Log.d(TAG, document.getId() + " => " + document.getData()); } } else { Log.w(TAG, "Error getting documents.", task.getException()); } } });
Dart
await db.collection("users").get().then((event) { for (var doc in event.docs) { print("${doc.id} => ${doc.data()}"); } });
Java
Python
users_ref = db.collection("users") docs = users_ref.stream() for doc in docs: print(f"{doc.id} => {doc.to_dict()}")
Python
C++
Future<QuerySnapshot> users = db->Collection("users").Get(); users.OnCompletion([](const Future<QuerySnapshot>& future) { if (future.error() == Error::kErrorOk) { for (const DocumentSnapshot& document : future.result()->documents()) { std::cout << document << std::endl; } } else { std::cout << "Error getting documents: " << future.error_message() << std::endl; } });
Node.js
Vai
PHP
PHP
Per saperne di più sull'installazione e sulla creazione di un client Cloud Firestore, consulta Librerie client Cloud Firestore.
Unity
CollectionReference usersRef = db.Collection("users"); usersRef.GetSnapshotAsync().ContinueWithOnMainThread(task => { QuerySnapshot snapshot = task.Result; foreach (DocumentSnapshot document in snapshot.Documents) { Debug.Log(String.Format("User: {0}", document.Id)); Dictionary<string, object> documentDictionary = document.ToDictionary(); Debug.Log(String.Format("First: {0}", documentDictionary["First"])); if (documentDictionary.ContainsKey("Middle")) { Debug.Log(String.Format("Middle: {0}", documentDictionary["Middle"])); } Debug.Log(String.Format("Last: {0}", documentDictionary["Last"])); Debug.Log(String.Format("Born: {0}", documentDictionary["Born"])); } Debug.Log("Read all data from the users collection."); });
C#
Ruby
Proteggi i tuoi dati
Se utilizzi l'SDK per le piattaforme web, Android o Apple, utilizza Firebase Authentication e Cloud Firestore Security Rules per proteggere i tuoi dati in Cloud Firestore.
Ecco alcuni insiemi di regole di base che puoi utilizzare per iniziare. Puoi modificare le regole di sicurezza nella scheda Regole della console.
Autenticazione richiesta
// Allow read/write access to a document keyed by the user's UID
service cloud.firestore {
match /databases/{database}/documents {
match /users/{uid} {
allow read, write: if request.auth != null && request.auth.uid == uid;
}
}
}
Modalità di blocco
// Deny read/write access to all users under any conditions
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
allow read, write: if false;
}
}
}
Prima di eseguire il deployment dell'app web, Android o iOS in produzione, adotta anche misure per assicurarti che solo i client dell'app possano accedere ai tuoi dati Cloud Firestore. Consulta la documentazione di App Check.
Se utilizzi uno degli SDK per il server, utilizza Identity and Access Management (IAM) per proteggere i tuoi dati in Cloud Firestore.
Guarda un tutorial video
Per indicazioni dettagliate su come iniziare a utilizzare le librerie client mobile di Cloud Firestore, guarda uno dei seguenti tutorial video:
Web
iOS+
Android
Puoi trovare altri video sul canale YouTube di Firebase.
Passaggi successivi
Approfondisci le tue conoscenze con i seguenti argomenti:
- Codelab: scopri come utilizzare Cloud Firestore in un'app reale seguendo il codelab per Android, iOS o web.
- Modello di dati: scopri di più su come vengono strutturati i dati in Cloud Firestore, inclusi i dati gerarchici e le sottocollezioni.
- Aggiungi dati: scopri di più sulla creazione e sull'aggiornamento dei dati in Cloud Firestore.
- Ottieni i dati: scopri di più su come recuperare i dati.
- Eseguire query semplici e composte: scopri come eseguire query semplici e composte.
- Ordina e limita le query Scopri come ordinare e limitare i dati restituiti dalle query.