Risparmio di dati

Questo documento illustra i quattro metodi per scrivere dati nel tuo Firebase Realtime Database: supporto per set, aggiornamenti, push e transazioni.

Modi per risparmiare dati

set	Scrivi o sostituisci i dati in un percorso definito, ad esempio messages/users/<username>
update	Aggiornare alcune chiavi per un percorso definito senza sostituire tutti i dati
eseguire il push	Aggiungere a un elenco di dati nel database. Ogni volta che inserisci un nuovo nodo in un elenco, il database genera una chiave univoca, ad esempio messages/users/<unique-user-id>/<username>
transazione	Utilizza le transazioni quando lavori con dati complessi che potrebbero essere danneggiati da aggiornamenti simultanei

Risparmio dati

L'operazione di scrittura di base del database è un set che salva i nuovi dati nel riferimento al database specificato, sostituendo tutti i dati esistenti nel percorso. Per comprendere Set, creeremo una semplice app di blogging. I dati della tua app sono archiviati in questo riferimento al database:

Java

final FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference ref = database.getReference("server/saving-data/fireblog");

Node.js

// Import Admin SDK
const { getDatabase } = require('firebase-admin/database');

// Get a database reference to our blog
const db = getDatabase();
const ref = db.ref('server/saving-data/fireblog');

Python

# Import database module.
from firebase_admin import db

# Get a database reference to our blog.
ref = db.reference('server/saving-data/fireblog')

Vai

// Create a database client from App.
client, err := app.Database(ctx)
if err != nil {
	log.Fatalln("Error initializing database client:", err)
}

// Get a database reference to our blog.
ref := client.NewRef("server/saving-data/fireblog")

Iniziamo salvando alcuni dati utente. Memorizzeremo ogni utente in base a un nome utente univoco, oltre al nome completo e alla data di nascita. Poiché ogni utente avrà un nome utente univoco, è consigliabile utilizzare il metodo set anziché il metodo push, in quanto la chiave è già disponibile e non è necessario crearne una.

Innanzitutto, crea un riferimento al database per i tuoi dati utente. Poi utilizza set() / setValue() per salvare un oggetto utente nel database con il nome utente, il nome completo e la data di nascita dell'utente. Puoi impostare una stringa, un numero, un valore booleano, null, un array o qualsiasi oggetto JSON. Il passaggio di null rimuoverà i dati nella posizione specificata. In questo caso, passerai un oggetto:

Java

public static class User {

  public String date_of_birth;
  public String full_name;
  public String nickname;

  public User(String dateOfBirth, String fullName) {
    // ...
  }

  public User(String dateOfBirth, String fullName, String nickname) {
    // ...
  }

}

DatabaseReference usersRef = ref.child("users");

Map<String, User> users = new HashMap<>();
users.put("alanisawesome", new User("June 23, 1912", "Alan Turing"));
users.put("gracehop", new User("December 9, 1906", "Grace Hopper"));

usersRef.setValueAsync(users);

Node.js

const usersRef = ref.child('users');
usersRef.set({
  alanisawesome: {
    date_of_birth: 'June 23, 1912',
    full_name: 'Alan Turing'
  },
  gracehop: {
    date_of_birth: 'December 9, 1906',
    full_name: 'Grace Hopper'
  }
});

Python

users_ref = ref.child('users')
users_ref.set({
    'alanisawesome': {
        'date_of_birth': 'June 23, 1912',
        'full_name': 'Alan Turing'
    },
    'gracehop': {
        'date_of_birth': 'December 9, 1906',
        'full_name': 'Grace Hopper'
    }
})

Vai

// User is a json-serializable type.
type User struct {
	DateOfBirth string `json:"date_of_birth,omitempty"`
	FullName    string `json:"full_name,omitempty"`
	Nickname    string `json:"nickname,omitempty"`
}

usersRef := ref.Child("users")
err := usersRef.Set(ctx, map[string]*User{
	"alanisawesome": {
		DateOfBirth: "June 23, 1912",
		FullName:    "Alan Turing",
	},
	"gracehop": {
		DateOfBirth: "December 9, 1906",
		FullName:    "Grace Hopper",
	},
})
if err != nil {
	log.Fatalln("Error setting value:", err)
}

Quando un oggetto JSON viene salvato nel database, le proprietà dell'oggetto vengono mappate automaticamente alle posizioni secondarie del database in modo nidificato. Ora, se vai all'URL https://docs-examples.firebaseio.com/server/saving-data/fireblog/users/alanisawesome/full_name, vedrai il valore "Alan Turing". Puoi anche salvare i dati direttamente in una posizione secondaria:

Java

usersRef.child("alanisawesome").setValueAsync(new User("June 23, 1912", "Alan Turing"));
usersRef.child("gracehop").setValueAsync(new User("December 9, 1906", "Grace Hopper"));

Node.js

const usersRef = ref.child('users');
usersRef.child('alanisawesome').set({
  date_of_birth: 'June 23, 1912',
  full_name: 'Alan Turing'
});
usersRef.child('gracehop').set({
  date_of_birth: 'December 9, 1906',
  full_name: 'Grace Hopper'
});

Python

users_ref.child('alanisawesome').set({
    'date_of_birth': 'June 23, 1912',
    'full_name': 'Alan Turing'
})
users_ref.child('gracehop').set({
    'date_of_birth': 'December 9, 1906',
    'full_name': 'Grace Hopper'
})

Vai

if err := usersRef.Child("alanisawesome").Set(ctx, &User{
	DateOfBirth: "June 23, 1912",
	FullName:    "Alan Turing",
}); err != nil {
	log.Fatalln("Error setting value:", err)
}

if err := usersRef.Child("gracehop").Set(ctx, &User{
	DateOfBirth: "December 9, 1906",
	FullName:    "Grace Hopper",
}); err != nil {
	log.Fatalln("Error setting value:", err)
}

I due esempi precedenti, ovvero la scrittura di entrambi i valori contemporaneamente come oggetto e la scrittura separata nelle posizioni secondarie, comporteranno il salvataggio degli stessi dati nel database:

{
  "users": {
    "alanisawesome": {
      "date_of_birth": "June 23, 1912",
      "full_name": "Alan Turing"
    },
    "gracehop": {
      "date_of_birth": "December 9, 1906",
      "full_name": "Grace Hopper"
    }
  }
}

Il primo esempio attiverà un solo evento sui client che osservano i dati, mentre il secondo ne attiverà due. È importante notare che se i dati esistevano già in usersRef, il primo approccio li sovrascriverebbe, mentre il secondo metodo modificherebbe solo il valore di ogni nodo secondario separato, lasciando invariati gli altri nodi secondari di usersRef.

L'impostazione del valore sovrascriverà i dati nella posizione specificata, inclusi eventuali nodi secondari.

Aggiornamento dei dati salvati

Se vuoi scrivere contemporaneamente a più figli di una posizione del database senza sovrascrivere altri nodi secondari, puoi utilizzare il metodo di aggiornamento come mostrato di seguito:

Java

DatabaseReference hopperRef = usersRef.child("gracehop");
Map<String, Object> hopperUpdates = new HashMap<>();
hopperUpdates.put("nickname", "Amazing Grace");

hopperRef.updateChildrenAsync(hopperUpdates);

Node.js

const usersRef = ref.child('users');
const hopperRef = usersRef.child('gracehop');
hopperRef.update({
  'nickname': 'Amazing Grace'
});

Python

hopper_ref = users_ref.child('gracehop')
hopper_ref.update({
    'nickname': 'Amazing Grace'
})

Vai

hopperRef := usersRef.Child("gracehop")
if err := hopperRef.Update(ctx, map[string]interface{}{
	"nickname": "Amazing Grace",
}); err != nil {
	log.Fatalln("Error updating child:", err)
}

In questo modo, i dati di Grace verranno aggiornati in modo da includere il suo soprannome. Se avessi utilizzato set qui anziché update, avresti eliminato sia full_name che date_of_birth da hopperRef.

Firebase Realtime Database supporta anche gli aggiornamenti multi-path. Ciò significa che l'aggiornamento ora può aggiornare i valori in più posizioni del database contemporaneamente, una funzionalità potente che ti consente di denormalizzare i dati. Utilizzando gli aggiornamenti multipath, puoi aggiungere soprannomi sia a Grace che ad Alan contemporaneamente:

Java

Map<String, Object> userUpdates = new HashMap<>();
userUpdates.put("alanisawesome/nickname", "Alan The Machine");
userUpdates.put("gracehop/nickname", "Amazing Grace");

usersRef.updateChildrenAsync(userUpdates);

Node.js

const usersRef = ref.child('users');
usersRef.update({
  'alanisawesome/nickname': 'Alan The Machine',
  'gracehop/nickname': 'Amazing Grace'
});

Python

users_ref.update({
    'alanisawesome/nickname': 'Alan The Machine',
    'gracehop/nickname': 'Amazing Grace'
})

Vai

if err := usersRef.Update(ctx, map[string]interface{}{
	"alanisawesome/nickname": "Alan The Machine",
	"gracehop/nickname":      "Amazing Grace",
}); err != nil {
	log.Fatalln("Error updating children:", err)
}

Dopo questo aggiornamento, sono stati aggiunti i nickname di Alan e Grace:

{
  "users": {
    "alanisawesome": {
      "date_of_birth": "June 23, 1912",
      "full_name": "Alan Turing",
      "nickname": "Alan The Machine"
    },
    "gracehop": {
      "date_of_birth": "December 9, 1906",
      "full_name": "Grace Hopper",
      "nickname": "Amazing Grace"
    }
  }
}

Tieni presente che il tentativo di aggiornare gli oggetti scrivendoli con i percorsi inclusi comporterà un comportamento diverso. Vediamo cosa succede se provi ad aggiornare Grace e Alan in questo modo:

Java

Map<String, Object> userNicknameUpdates = new HashMap<>();
userNicknameUpdates.put("alanisawesome", new User(null, null, "Alan The Machine"));
userNicknameUpdates.put("gracehop", new User(null, null, "Amazing Grace"));

usersRef.updateChildrenAsync(userNicknameUpdates);

Node.js

const usersRef = ref.child('users');
usersRef.update({
  'alanisawesome': {
    'nickname': 'Alan The Machine'
  },
  'gracehop': {
    'nickname': 'Amazing Grace'
  }
});

Python

users_ref.update({
    'alanisawesome': {
        'nickname': 'Alan The Machine'
    },
    'gracehop': {
        'nickname': 'Amazing Grace'
    }
})

Vai

if err := usersRef.Update(ctx, map[string]interface{}{
	"alanisawesome": &User{Nickname: "Alan The Machine"},
	"gracehop":      &User{Nickname: "Amazing Grace"},
}); err != nil {
	log.Fatalln("Error updating children:", err)
}

Ciò comporta un comportamento diverso, ovvero la sovrascrittura dell'intero nodo /users:

{
  "users": {
    "alanisawesome": {
      "nickname": "Alan The Machine"
    },
    "gracehop": {
      "nickname": "Amazing Grace"
    }
  }
}

Aggiornamento dei dati nidificati

Dato un singolo percorso chiave come alanisawesome, vengono aggiornati solo i dati al primo livello secondario e tutti i dati passati oltre il primo livello secondario vengono trattati come un'operazione di impostazione. Il comportamento multi-path consente di utilizzare percorsi più lunghi (come alanisawesome/nickname) senza sovrascrivere i dati. Per questo motivo, il primo esempio è diverso dal secondo.

Aggiunta di un callback di completamento

Negli SDK Node.js e Java Admin, se vuoi sapere quando i tuoi dati sono stati salvati, puoi aggiungere un callback di completamento. Entrambi i metodi set e update in questi SDK accettano un callback di completamento facoltativo che viene chiamato quando la scrittura è stata eseguita nel database. Se la chiamata non è andata a buon fine per qualche motivo, al callback viene passato un oggetto di errore che indica il motivo del problema. Negli SDK Admin Python e Go, tutti i metodi di scrittura sono bloccanti. ovvero i metodi di scrittura non vengono restituiti finché le scritture non vengono eseguite nel database.

Java

DatabaseReference dataRef = ref.child("data");
dataRef.setValue("I'm writing data", new DatabaseReference.CompletionListener() {
  @Override
  public void onComplete(DatabaseError databaseError, DatabaseReference databaseReference) {
    if (databaseError != null) {
      System.out.println("Data could not be saved " + databaseError.getMessage());
    } else {
      System.out.println("Data saved successfully.");
    }
  }
});

Node.js

dataRef.set('I\'m writing data', (error) => {
  if (error) {
    console.log('Data could not be saved.' + error);
  } else {
    console.log('Data saved successfully.');
  }
});

Salvataggio di elenchi di dati

Quando crei elenchi di dati, è importante tenere presente la natura multiutente della maggior parte delle applicazioni e modificare di conseguenza la struttura dell'elenco. Ampliando l'esempio precedente, aggiungiamo i post del blog alla tua app. Il tuo primo istinto potrebbe essere quello di utilizzare set per archiviare i figli con indici interi a incremento automatico, come il seguente:

// NOT RECOMMENDED - use push() instead!
{
  "posts": {
    "0": {
      "author": "gracehop",
      "title": "Announcing COBOL, a New Programming Language"
    },
    "1": {
      "author": "alanisawesome",
      "title": "The Turing Machine"
    }
  }
}

Push e transazione

Quando si lavora con elenchi di dati, push() garantisce una chiave univoca e cronologica. Potresti essere tentato di utilizzare le transazioni per generare le tue chiavi, ma push è una scelta molto migliore. Le transazioni sono più lente e più complesse. Richiedono uno o più round trip al server. Una chiave generata da `push()` sul client funziona offline ed è ottimizzata per il rendimento.

Se un utente aggiunge un nuovo post, questo verrà memorizzato come /posts/2. Questo funzionerebbe se un solo autore aggiungesse post, ma nella tua applicazione di blogging collaborativo molti utenti potrebbero aggiungere post contemporaneamente. Se due autori scrivono a /posts/2 contemporaneamente, uno dei post verrà eliminato dall'altro.

Per risolvere questo problema, i client Firebase forniscono una funzione push() che genera una chiave univoca per ogni nuovo figlio. Utilizzando chiavi secondarie uniche, più client possono aggiungere figli alla stessa posizione contemporaneamente senza preoccuparsi di conflitti di scrittura.

Java

public static class Post {

  public String author;
  public String title;

  public Post(String author, String title) {
    // ...
  }

}

DatabaseReference postsRef = ref.child("posts");

DatabaseReference newPostRef = postsRef.push();
newPostRef.setValueAsync(new Post("gracehop", "Announcing COBOL, a New Programming Language"));

// We can also chain the two calls together
postsRef.push().setValueAsync(new Post("alanisawesome", "The Turing Machine"));

Node.js

const newPostRef = postsRef.push();
newPostRef.set({
  author: 'gracehop',
  title: 'Announcing COBOL, a New Programming Language'
});

// we can also chain the two calls together
postsRef.push().set({
  author: 'alanisawesome',
  title: 'The Turing Machine'
});

Python

posts_ref = ref.child('posts')

new_post_ref = posts_ref.push()
new_post_ref.set({
    'author': 'gracehop',
    'title': 'Announcing COBOL, a New Programming Language'
})

# We can also chain the two calls together
posts_ref.push().set({
    'author': 'alanisawesome',
    'title': 'The Turing Machine'
})

Vai

// Post is a json-serializable type.
type Post struct {
	Author string `json:"author,omitempty"`
	Title  string `json:"title,omitempty"`
}

postsRef := ref.Child("posts")

newPostRef, err := postsRef.Push(ctx, nil)
if err != nil {
	log.Fatalln("Error pushing child node:", err)
}

if err := newPostRef.Set(ctx, &Post{
	Author: "gracehop",
	Title:  "Announcing COBOL, a New Programming Language",
}); err != nil {
	log.Fatalln("Error setting value:", err)
}

// We can also chain the two calls together
if _, err := postsRef.Push(ctx, &Post{
	Author: "alanisawesome",
	Title:  "The Turing Machine",
}); err != nil {
	log.Fatalln("Error pushing child node:", err)
}

La chiave univoca si basa su un timestamp, quindi gli elementi dell'elenco verranno ordinati automaticamente in ordine cronologico. Poiché Firebase genera una chiave univoca per ogni post del blog, non si verificano conflitti di scrittura se più utenti aggiungono un post contemporaneamente. I dati del database ora hanno il seguente aspetto:

{
  "posts": {
    "-JRHTHaIs-jNPLXOQivY": {
      "author": "gracehop",
      "title": "Announcing COBOL, a New Programming Language"
    },
    "-JRHTHaKuITFIhnj02kE": {
      "author": "alanisawesome",
      "title": "The Turing Machine"
    }
  }
}

In JavaScript, Python e Go, il pattern di chiamata di push() e poi immediatamente di set() è così comune che l'SDK Firebase ti consente di combinarli passando i dati da impostare direttamente a push() nel seguente modo:

Java

// No Java equivalent

Node.js

// This is equivalent to the calls to push().set(...) above
postsRef.push({
  author: 'gracehop',
  title: 'Announcing COBOL, a New Programming Language'
});;

Python

# This is equivalent to the calls to push().set(...) above
posts_ref.push({
    'author': 'gracehop',
    'title': 'Announcing COBOL, a New Programming Language'
})

Vai

if _, err := postsRef.Push(ctx, &Post{
	Author: "gracehop",
	Title:  "Announcing COBOL, a New Programming Language",
}); err != nil {
	log.Fatalln("Error pushing child node:", err)
}

Ottenere la chiave univoca generata da push()

La chiamata di push() restituirà un riferimento al nuovo percorso dei dati, che puoi utilizzare per ottenere la chiave o impostare i dati. Il seguente codice genererà gli stessi dati dell'esempio precedente, ma ora avremo accesso alla chiave univoca generata:

Java

// Generate a reference to a new location and add some data using push()
DatabaseReference pushedPostRef = postsRef.push();

// Get the unique ID generated by a push()
String postId = pushedPostRef.getKey();

Node.js

// Generate a reference to a new location and add some data using push()
const newPostRef = postsRef.push();

// Get the unique key generated by push()
const postId = newPostRef.key;

Python

# Generate a reference to a new location and add some data using push()
new_post_ref = posts_ref.push()

# Get the unique key generated by push()
post_id = new_post_ref.key

Vai

// Generate a reference to a new location and add some data using Push()
newPostRef, err := postsRef.Push(ctx, nil)
if err != nil {
	log.Fatalln("Error pushing child node:", err)
}

// Get the unique key generated by Push()
postID := newPostRef.Key

Come puoi vedere, puoi ottenere il valore della chiave univoca dal riferimento push().

Nella sezione successiva, Recupero dei dati, impareremo a leggere questi dati da un database Firebase.

Salvataggio dei dati transazionali

Quando lavori con dati complessi che potrebbero essere danneggiati da modifiche simultanee, ad esempio contatori incrementali, l'SDK fornisce un'operazione di transazione.

In Java e Node.js, fornisci all'operazione di transazione due callback: una funzione di aggiornamento e un callback di completamento facoltativo. In Python e Go, l'operazione di transazione è bloccante e pertanto accetta solo la funzione di aggiornamento.

La funzione di aggiornamento accetta lo stato attuale dei dati come argomento e deve restituire il nuovo stato desiderato che vuoi scrivere. Ad esempio, se vuoi incrementare il numero di voti positivi per un post del blog specifico, scriverai una transazione come la seguente:

Java

DatabaseReference upvotesRef = ref.child("server/saving-data/fireblog/posts/-JRHTHaIs-jNPLXOQivY/upvotes");
upvotesRef.runTransaction(new Transaction.Handler() {
  @Override
  public Transaction.Result doTransaction(MutableData mutableData) {
    Integer currentValue = mutableData.getValue(Integer.class);
    if (currentValue == null) {
      mutableData.setValue(1);
    } else {
      mutableData.setValue(currentValue + 1);
    }

    return Transaction.success(mutableData);
  }

  @Override
  public void onComplete(
      DatabaseError databaseError, boolean committed, DataSnapshot dataSnapshot) {
    System.out.println("Transaction completed");
  }
});

Node.js

const upvotesRef = db.ref('server/saving-data/fireblog/posts/-JRHTHaIs-jNPLXOQivY/upvotes');
upvotesRef.transaction((current_value) => {
  return (current_value || 0) + 1;
});

Python

def increment_votes(current_value):
    return current_value + 1 if current_value else 1

upvotes_ref = db.reference('server/saving-data/fireblog/posts/-JRHTHaIs-jNPLXOQivY/upvotes')
try:
    new_vote_count = upvotes_ref.transaction(increment_votes)
    print('Transaction completed')
except db.TransactionAbortedError:
    print('Transaction failed to commit')

Vai

fn := func(t db.TransactionNode) (interface{}, error) {
	var currentValue int
	if err := t.Unmarshal(&currentValue); err != nil {
		return nil, err
	}
	return currentValue + 1, nil
}

ref := client.NewRef("server/saving-data/fireblog/posts/-JRHTHaIs-jNPLXOQivY/upvotes")
if err := ref.Transaction(ctx, fn); err != nil {
	log.Fatalln("Transaction failed to commit:", err)
}

L'esempio precedente verifica se il contatore è null o non è ancora stato incrementato, poiché le transazioni possono essere chiamate con null se non è stato scritto alcun valore predefinito.

Se il codice precedente fosse stato eseguito senza una funzione di transazione e due client avessero tentato di incrementarlo contemporaneamente, entrambi avrebbero scritto 1 come nuovo valore, con conseguente incremento di uno anziché due.

La funzione di transazione viene chiamata più volte

Il gestore delle transazioni viene chiamato più volte e deve essere in grado di gestire i dati null. Anche se nel database sono presenti dati esistenti, è possibile che non vengano memorizzati nella cache locale quando viene eseguita la funzione di transazione.

Connettività di rete e scritture offline

In Node.js e Java, se un client perde la connessione di rete, la tua app continuerà a funzionare correttamente. Gli SDK Admin Python e Go richiedono la connettività di rete perché utilizzano l'API REST di Firebase per comunicare con il server di database. L'invocazione di operazioni di database sugli SDK Admin Python o Go senza connettività di rete genera eccezioni.

I client Firebase Node.js e Java gestiscono la propria versione interna di tutti i dati attivi. Quando i dati vengono scritti, vengono scritti prima in questa versione locale. Il client sincronizza quindi i dati con il database e con altri client in base al principio del "best effort".

Di conseguenza, tutte le scritture nel database attiveranno immediatamente gli eventi locali, prima ancora che i dati vengano scritti nel database. Ciò significa che quando scrivi un'applicazione utilizzando Firebase, la tua app rimarrà reattiva indipendentemente dalla latenza di rete o dalla connettività a internet.

Una volta ristabilita la connettività, riceveremo il set appropriato di eventi in modo che il client "recuperi" lo stato attuale del server, senza dover scrivere codice personalizzato.

Protezione dei dati

Firebase Realtime Database ha un linguaggio di sicurezza che ti consente di definire quali utenti hanno accesso in lettura e scrittura a diversi nodi dei tuoi dati. Puoi saperne di più in Proteggere i dati.