Estructura tu base de datos

Antes de comenzar

Para usar Firebase Realtime Database, debes crear un proyecto de Firebase y agregar los paquetes del SDK de Firebase Unity al proyecto de Unity.

Configuración:

Requisitos previos

Android

  • Unity 5.0 o una versión más reciente
  • NDK de Android 10d o una versión más reciente

iOS

  • Unity 5.0 o una versión más reciente
  • Xcode 8.0 o una versión más reciente

Si todavía no tienes un proyecto de Unity, puedes descargar uno de los ejemplos de inicio rápido para probar una función de Firebase específica. Si usas un ejemplo de inicio rápido, recuerda consultar el identificador de paquete en la configuración del proyecto, ya que lo necesitarás en el próximo paso.

Configura la app en Firebase console

Para agregar Firebase a la app, debes tener un proyecto y un archivo de configuración de Firebase.

Para crear un proyecto de Firebase:

  1. Dirígete a Firebase console.

  2. Haz clic en Agregar proyecto, luego selecciona o ingresa un Nombre del proyecto.

    • Si hay un proyecto de Google existente asociado con tu app, selecciónalo desde el menú desplegable Nombre del proyecto.
    • Si no hay un proyecto de Google existente, ingresa un nuevo Nombre del proyecto.
  3. (Opcional) Edita el ID del proyecto.

    Firebase asignará de manera automática un ID único a tu proyecto de Firebase. Este identificador se muestra en los servicios de Firebase visibles de forma pública, por ejemplo:

    • URL predeterminada para la base de datos: your-project-id.firebaseio.com
    • Subdominio de hosting predeterminado: your-project-id.firebaseapp.com
  4. Sigue los pasos de configuración restantes y, luego, haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto de Google existente).

Firebase aprovisiona los recursos para tu proyecto de forma automática. Este proceso suele tardar algunos minutos. Cuando finalice, verás la página descripción general del proyecto en Firebase console.

Android

  1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el nombre del paquete de la app cuando se te solicite. Es importante que ingreses el nombre de paquete que usa la app. Esta configuración solo puede hacerse cuando agregas una app al proyecto de Firebase.
  3. Durante el proceso, descargarás un archivo google-services.json. Puedes volver a descargarlo en cualquier momento.
  4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.

iOS

  1. Haz clic en Agrega Firebase a la app para iOS y sigue los pasos de configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el ID del paquete de la app cuando se te solicite. Es importante que ingreses el ID del paquete que usa la app. Esta configuración solo puede hacerse cuando agregas una app al proyecto de Firebase.
  3. Durante el proceso, descargarás un archivo GoogleService-Info.plist. Puedes volver a descargarlo en cualquier momento.
  4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.
  5. Arrastra el archivo GoogleService-Info.plist que se descargó de Firebase console a cualquier carpeta del proyecto de Unity.

Agrega el SDK de Firebase Unity a la app

  1. Descarga el SDK de Firebase Unity.
  2. Selecciona el elemento de menú Activos > Importar paquete > Paquete personalizado.
  3. Importa FirebaseDatabase.unitypackage desde el directorio que coincide con la versión de Unity que usas:
    • Unity 5.x y las versiones anteriores usan .NET Framework 3.x, de modo que debes importar el paquete dotnet3/FirebaseDatabase.unitypackage .
    • Unity 2017.x y las versiones posteriores usan .NET Framework 4.x. Si tu proyecto está configurado para usar .NET 4.x, importa el paquete dotnet4/FirebaseDatabase.unitypackage .
  4. Cuando aparezca la ventana Importar paquete de Unity, haz clic en el botón Importar.

Inicializa el SDK

El SDK de Firebase Unity en Android requiere los Servicios de Google Play actualizados. Se debe agregar el siguiente código al inicio de la aplicación para buscar y, de forma opcional, actualizar los Servicios de Google Play a la versión que requiera el SDK de Firebase Unity a fin de que sea posible llamar a otros métodos en el SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp, i.e.
    //   app = Firebase.FirebaseApp.DefaultInstance;
    // where app is a Firebase.FirebaseApp property of your application class.

    // Set a flag here indicating that Firebase is ready to use by your
    // application.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Compila la app

Android

  1. Selecciona la opción de menú Archivo > Configuración de compilación.
  2. Selecciona Android en la lista Plataforma.
  3. Haz clic en Cambiar plataforma para establecer Android como plataforma seleccionada.
  4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Compilar y ejecutar.

iOS

  1. Selecciona la opción de menú Archivo > Configuración de compilación.
  2. Selecciona iOS en la lista Plataforma.
  3. Haz clic en Cambiar plataforma para establecer iOS como plataforma seleccionada.
  4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Compilar y ejecutar.

Estructuración de datos

En esta guía, se presentan algunos de los conceptos clave sobre la arquitectura de datos y las prácticas recomendadas para la estructuración de los datos JSON de tu Firebase Realtime Database.

La creación de una base de datos estructurada de forma adecuada requiere bastante previsión. La parte más importante es planificar cómo se guardarán y recuperarán los datos para que el proceso sea lo más simple posible.

Cómo se estructuran los datos: Un árbol JSON

Todos los datos de Firebase Realtime Database se almacenan como objetos JSON. La base de datos puede conceptualizarse como un árbol JSON alojado en la nube. A diferencia de una base de datos de SQL, no hay tablas ni registros. Cuando le agregas datos al árbol JSON, estos se convierten en un nodo de la estructura JSON existente con una clave asociada. Puedes proporcionar tus propias claves, como ID de usuario o nombres semánticos, y también puedes obtenerlas mediante el método Push().

Si creas tus propias claves, deben usar codificación UTF-8, pueden tener un máximo de 768 bytes y no pueden contener los caracteres ., $, #, [, ], / ni los caracteres de control ASCII del 0 al 31 ni el 127. Tampoco puedes usar los caracteres de control ASCII en los propios valores.

Por ejemplo, imagina una aplicación de chat que permite que los usuarios almacenen un perfil básico y una lista de contactos. Un perfil de usuario común se ubica en una ruta de acceso, como /users/$uid. El usuario alovelace podría tener una entrada en la base de datos similar a la siguiente:

{
  "users": {
    "alovelace": {
      "name": "Ada Lovelace",
      "contacts": { "ghopper": true },
    },
    "ghopper": { ... },
    "eclarke": { ... }
  }
}

Aunque la base de datos usa un árbol JSON, los datos almacenados en ella pueden representarse como determinados tipos nativos que corresponden a los tipos de JSON disponibles, a fin de que puedas escribir un código más fácil de mantener.

Recomendaciones para la estructura de datos

Evita la anidación de datos

Debido a que Firebase Realtime Database permite anidar datos en un máximo de 32 niveles, es posible que te resulte tentador pensar que esta debe ser la estructura predeterminada. Sin embargo, cuando obtienes datos de una ubicación de la base de datos, también se recuperan todos los nodos secundarios. Además, cuando le otorgas a alguien acceso de lectura o escritura en un nodo de la base de datos, también le otorgas acceso a todos los datos que se encuentran en ese nodo. Por lo tanto, en la práctica, lo ideal es que la estructura de los datos sea lo más simple posible.

Para entender mejor por qué no son una buena opción los datos anidados, considera la siguiente estructura de anidación en varios niveles:

{
  // This is a poorly nested data architecture, because iterating the children
  // of the "chats" node to get a list of conversation titles requires
  // potentially downloading hundreds of megabytes of messages
  "chats": {
    "one": {
      "title": "Historical Tech Pioneers",
      "messages": {
        "m1": { "sender": "ghopper", "message": "Relay malfunction found. Cause: moth." },
        "m2": { ... },
        // a very long list of messages
      }
    },
    "two": { ... }
  }
}

Con este diseño anidado, se vuelve problemática la iteración de datos. Por ejemplo, para obtener una lista de los títulos de conversaciones de chat, debe descargarse al cliente todo el árbol chats, incluidos todos los miembros y los mensajes.

Compacta las estructuras de datos

Por el contrario, si los datos se dividen en rutas de acceso independientes, que también se conocen como no normalizadas, se pueden descargar de manera eficaz en llamadas separadas, según sea necesario. Considera esta estructura compacta:

{
  // Chats contains only meta info about each conversation
  // stored under the chats's unique ID
  "chats": {
    "one": {
      "title": "Historical Tech Pioneers",
      "lastMessage": "ghopper: Relay malfunction found. Cause: moth.",
      "timestamp": 1459361875666
    },
    "two": { ... },
    "three": { ... }
  },

  // Conversation members are easily accessible
  // and stored by chat conversation ID
  "members": {
    // we'll talk about indices like this below
    "one": {
      "ghopper": true,
      "alovelace": true,
      "eclarke": true
    },
    "two": { ... },
    "three": { ... }
  },

  // Messages are separate from data we may want to iterate quickly
  // but still easily paginated and queried, and organized by chat
  // conversation ID
  "messages": {
    "one": {
      "m1": {
        "name": "eclarke",
        "message": "The relay seems to be malfunctioning.",
        "timestamp": 1459361875337
      },
      "m2": { ... },
      "m3": { ... }
    },
    "two": { ... },
    "three": { ... }
  }
}

Ahora, es posible iterar la lista de salas, para lo cual solo se descargan algunos bytes de cada conversación. Esto permite obtener rápidamente los metadatos necesarios para generar una lista o mostrar las salas en la IU. Los mensajes se pueden obtener por separado y mostrarse cuando llegan, lo que permite que la IU sea ágil y rápida.

Crea datos escalables

Cuando se crean apps, por lo general es mejor descargar un subconjunto de una lista. Esto resulta particularmente común si la lista contiene miles de registros. Cuando esta relación es estática y unidireccional, simplemente se pueden anidar los objetos secundarios bajo los primarios.

A veces, esta relación es más dinámica o tal vez se necesite desnormalizar los datos. En muchas ocasiones, los datos pueden desnormalizarse mediante una consulta para recuperar un subconjunto de los datos, tal como se explica en Cómo recuperar datos.

Pero incluso esto puede no ser suficiente. Por ejemplo, considera una relación bidireccional entre usuarios y grupos. Los usuarios pueden pertenecer a un grupo y los grupos son una lista de usuarios. Pero cuando llega el momento de decidir a qué grupo pertenece un usuario, la situación se complica.

Se necesita un modo elegante de obtener una lista de los grupos a los que pertenece un usuario y obtener solo los datos correspondientes a esos grupos. Para ello, puede ser útil contar con un índice de grupos:

// An index to track Ada's memberships
{
  "users": {
    "alovelace": {
      "name": "Ada Lovelace",
      // Index Ada's groups in her profile
      "groups": {
         // the value here doesn't matter, just that the key exists
         "techpioneers": true,
         "womentechmakers": true
      }
    },
    ...
  },
  "groups": {
    "techpioneers": {
      "name": "Historical Tech Pioneers",
      "members": {
        "alovelace": true,
        "ghopper": true,
        "eclarke": true
      }
    },
    ...
  }
}

Posiblemente hayas notado que esto duplica algunos datos, ya que la relación se almacena tanto en el registro de Ada como en el grupo. Ahora, alovelace está indexada en un grupo y techpioneers está incluido en el perfil de Ada. Por lo tanto, para eliminar del grupo a Ada, es necesario actualizar la información en dos lugares.

Es una redundancia necesaria para una relación bidireccional. Esto permite obtener la información de los grupos a los que pertenece Ada con rapidez y eficacia, incluso si la lista de usuarios o grupos contiene millones de elementos o si hay reglas de seguridad de Realtime Database que impiden el acceso a algunos de los registros.

Este enfoque, en el que se invierten los datos mediante la enumeración de los ID como claves y la asignación del valor "true", hace que buscar una clave sea tan sencillo como leer /users/$uid/groups/$group_id y comprobar si el valor es null. El índice es más rápido y mucho más eficiente que consultar o analizar los datos.

Pasos siguientes

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.