¿Para qué sirve el tipo de datos 'Referencia' de Firebase Firestore?

Solo estoy explorando el nuevo Firebase Firestore y contiene un tipo de datos llamado reference. No me queda claro qué hace esto.

• ¿Es como una clave foránea?
• ¿Se puede usar para apuntar a una colección que se encuentra en otro lugar?
• Si referencees una referencia real, ¿puedo usarla para consultas? Por ejemplo, ¿puedo tener una referencia que apunte directamente al usuario, en lugar de almacenar el ID de usuario en un campo de texto? ¿Y puedo usar esta referencia de usuario para realizar consultas?

Las referencias son muy parecidas a las claves externas.

Los SDK publicados actualmente no pueden almacenar referencias a otros proyectos. Dentro de un proyecto, las referencias pueden apuntar a cualquier otro documento en cualquier otra colección.

Puede utilizar referencias en consultas como cualquier otro valor: para filtrar, ordenar y para paginación (startAt / startAfter).

A diferencia de las claves foráneas en una base de datos SQL, las referencias no son útiles para realizar uniones en una sola consulta. Puede usarlos para búsquedas dependientes (que parecen unidas), pero tenga cuidado porque cada salto dará como resultado otro viaje de ida y vuelta al servidor.

Agregando a continuación lo que funcionó para mí usando referencias en Firestore.

Como dicen las otras respuestas, es como una clave externa. Sin embargo, el atributo de referencia no devuelve los datos del documento de referencia. Por ejemplo, tengo una lista de productos, con una referencia de UserRef como uno de los atributos del producto. Obtener la lista de productos me da la referencia del usuario que creó ese producto. Pero no me da los detalles del usuario en esa referencia. He usado otro back-end como servicios con punteros antes que tienen un indicador "populate: true" que devuelve los detalles del usuario en lugar de solo la identificación de referencia del usuario, lo cual sería genial tener aquí (con suerte, una mejora futura )

A continuación se muestra un código de ejemplo que utilicé para establecer la referencia, así como obtener la colección de la lista de productos y luego obtener los detalles del usuario a partir de la identificación de referencia del usuario dada.

Establecer una referencia en una colección:

let data = {
  name: 'productName',
  size: 'medium',
  userRef: db.doc('users/' + firebase.auth().currentUser.uid)
};
db.collection('products').add(data);

Obtenga una colección (productos) y todas las referencias en cada documento (detalles del usuario):

db.collection('products').get()
    .then(res => {
      vm.mainListItems = [];
      res.forEach(doc => {
        let newItem = doc.data();
        newItem.id = doc.id;
        if (newItem.userRef) {
          newItem.userRef.get()
          .then(res => { 
            newItem.userData = res.data() 
            vm.mainListItems.push(newItem);
          })
          .catch(err => console.error(err));
        } else {
          vm.mainListItems.push(newItem);  
        }

      });
    })
    .catch(err => { console.error(err) });

Espero que esto ayude

Para aquellos que buscan una solución Javascript para realizar consultas por referencia, el concepto es que debe usar un objeto 'referencia de documento' en la declaración de consulta

teamDbRef = db.collection('teams').doc('CnbasS9cZQ2SfvGY2r3b'); /* CnbasS9cZQ2SfvGY2r3b being the collection ID */
//
//
db.collection("squad").where('team', '==', teamDbRef).get().then((querySnapshot) => {
  //
}).catch(function(error) {
  //
});

(Felicitaciones a la respuesta aquí: https://stackoverflow.com/a/53141199/1487867 )