Eliminazione dei dati con una funzione Cloud richiamabile
La pagina descrive come utilizzare una Cloud Function richiamabile per eliminare i dati. Una volta eseguito il deployment di questa funzione, puoi chiamarlo direttamente dalla tua app mobile o dal tuo sito web eliminare in modo ricorsivo documenti e raccolte. Ad esempio, puoi utilizzare questo per consentire a utenti selezionati di eliminare intere raccolte.
Per altri modi di eliminare le raccolte, vedi Eliminare i dati.
Soluzione: eliminare i dati con una Cloud Function richiamabile
L'eliminazione di intere raccolte da un'app mobile con risorse limitate può essere difficile per i seguenti motivi:
- Non esiste un'operazione che elimini atomicamente una raccolta.
- L'eliminazione di un documento non comporta l'eliminazione dei documenti nelle sue sottoraccolte.
- Se i tuoi documenti hanno sottoraccolte dinamiche, può essere difficile sapere quale i dati da eliminare per un determinato percorso.
- L'eliminazione di una raccolta di più di 500 documenti richiede più operazioni di scrittura in batch o centinaia di eliminazioni singole.
- In molte app non è appropriato concedere agli utenti finali l'autorizzazione a eliminare intere raccolte.
Fortunatamente, puoi scrivere una funzione Cloud Functions richiamabile per eseguire eliminazioni sicure e ad alte prestazioni di intere raccolte o strutture di raccolta. La funzione Cloud Functions riportata di seguito implementa una funzione richiamabile il che significa che puoi chiamarla direttamente dall'app o dal sito web per dispositivi mobili per una funzione locale.
Per eseguire il deployment della funzione e provare una demo, guarda il codice campione.
Funzione Cloud Functions
La funzione Cloud Functions riportata di seguito elimina una raccolta e tutti i relativi discendenti.
Invece di implementare la tua logica di eliminazione ricorsiva per la tua Cloud Function,
puoi utilizzare il comando firestore:delete
Interfaccia a riga di comando (CLI) di Firebase. Puoi importare qualsiasi funzione
Interfaccia a riga di comando di Firebase nella tua applicazione Node.js utilizzando il pacchetto firebase-tools.
L'interfaccia a riga di comando di Firebase utilizza l'API REST Firestore per trovare tutti i documenti nel percorso specificato ed eliminarli singolarmente. Questa implementazione non richiede alcuna conoscenza della gerarchia dei dati specifica dell'app e troverà ed eliminerà "orfani" documenti che non hanno più parent.
Node.js
/**
* Initiate a recursive delete of documents at a given path.
*
* The calling user must be authenticated and have the custom "admin" attribute
* set to true on the auth token.
*
* This delete is NOT an atomic operation and it's possible
* that it may fail after only deleting some documents.
*
* @param {string} data.path the document or collection path to delete.
*/
exports.recursiveDelete = functions
.runWith({
timeoutSeconds: 540,
memory: '2GB'
})
.https.onCall(async (data, context) => {
// Only allow admin users to execute this function.
if (!(context.auth && context.auth.token && context.auth.token.admin)) {
throw new functions.https.HttpsError(
'permission-denied',
'Must be an administrative user to initiate delete.'
);
}
const path = data.path;
console.log(
`User ${context.auth.uid} has requested to delete path ${path}`
);
// Run a recursive delete on the given document or collection path.
// The 'token' must be set in the functions config, and can be generated
// at the command line by running 'firebase login:ci'.
await firebase_tools.firestore
.delete(path, {
project: process.env.GCLOUD_PROJECT,
recursive: true,
force: true,
token: functions.config().fb.token
});
return {
path: path
};
});Chiamata client
Per chiamare la funzione, ottieni un riferimento alla funzione dall'SDK Firebase e trasmettere i parametri richiesti:
Web
/**
* Call the 'recursiveDelete' callable function with a path to initiate
* a server-side delete.
*/
function deleteAtPath(path) {
var deleteFn = firebase.functions().httpsCallable('recursiveDelete');
deleteFn({ path: path })
.then(function(result) {
logMessage('Delete success: ' + JSON.stringify(result));
})
.catch(function(err) {
logMessage('Delete failed, see console,');
console.warn(err);
});
}
Swift
// Snippet not yet written
Objective-C
// Snippet not yet written
Kotlin+KTX
Android
/**
* Call the 'recursiveDelete' callable function with a path to initiate
* a server-side delete.
*/
fun deleteAtPath(path: String) {
val deleteFn = Firebase.functions.getHttpsCallable("recursiveDelete")
deleteFn.call(hashMapOf("path" to path))
.addOnSuccessListener {
// Delete Success
// ...
}
.addOnFailureListener {
// Delete Failed
// ...
}
}
Java
Android
/**
* Call the 'recursiveDelete' callable function with a path to initiate
* a server-side delete.
*/
public void deleteAtPath(String path) {
Map<String, Object> data = new HashMap<>();
data.put("path", path);
HttpsCallableReference deleteFn =
FirebaseFunctions.getInstance().getHttpsCallable("recursiveDelete");
deleteFn.call(data)
.addOnSuccessListener(new OnSuccessListener<HttpsCallableResult>() {
@Override
public void onSuccess(HttpsCallableResult httpsCallableResult) {
// Delete Success
// ...
}
})
.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(@NonNull Exception e) {
// Delete failed
// ...
}
});
}
Utilizzando l'SDK client per le funzioni Cloud Functions richiamabili, l'autenticazione dell'utente
e il parametro path vengono passati senza problemi alla funzione remota.
Quando la funzione viene completata, il client riceve un callback con il parametro
un risultato o un'eccezione. Per scoprire come chiamare una funzione Cloud Functions
Per Android, Apple o un'altra piattaforma, leggi la documentazione.
Limitazioni
La soluzione mostrata sopra mostra l'eliminazione di raccolte da un account di Google, ma tieni presente le seguenti limitazioni:
- Coerenza: il codice riportato sopra elimina i documenti uno alla volta. Se la query mentre è in corso un'operazione di eliminazione, i risultati potrebbero riflettere uno stato parzialmente completo in cui vengono eliminati solo alcuni documenti scelti come target. Non vi è inoltre alcuna garanzia che le operazioni di eliminazione abbiano esito positivo ma non in modo uniforme, quindi preparati a gestire i casi di eliminazione parziale.
- Timeout: la funzione riportata sopra è configurata per essere eseguita per un massimo di 540 secondi prima del timeout. Il codice di eliminazione può eliminare 4000 di documenti al secondo, nel migliore dei casi. Se devi eliminare più di 2.000.000 di documenti, ti consigliamo di eseguire l'operazione autonomamente in modo che non scada. Per un esempio di come eliminare dal tuo server, consulta l'articolo Eliminare le raccolte.