Introducción a NerdStorage

Para ayudarlo a crear una aplicación New Relic, le proporcionamos el SDK de New Relic One. En esta página, aprenderá a emplear los componentes del SDK de NerdStorage.

Emplee NerdStorage en sus aplicaciones

Puede emplear NerdStorage para almacenar y recuperar conjuntos simples de datos, incluidos ajustes y preferencias de configuración del usuario, como favoritos, o cualquier otro pequeño conjunto de datos. Este almacenamiento es único por Nerdpack y no se puede compartir con ningún otro Nerdpack.

NerdStorage se divide en tres categorías:

Almacenamiento de usuario: datos que se anexan a un usuario en individuo. Si está autenticado como el usuario al que se anexan los datos, puede leerlos y escribirlos.
Almacenamiento de cuenta: datos adjuntos a una cuenta en individua. Si está autenticado y puede acceder a la cuenta, puede leer y escribir en NerdStorage con ámbito de cuenta. La visibilidad de los datos de la cuenta también está determinada por las reglas de la cuenta maestra o subcuenta: si un usuario tiene acceso a la cuenta maestra, también tendrá acceso a los datos de todas las subcuentas.
Almacenamiento de entidad: Datos que se anexan a una entidad en individua. Si puede ver la entidad correspondiente, puede leer y escribir datos sobre esa entidad.

Modelo de datos

Puedes imaginar NerdStorage como un mapa principal de valor anidado. Los datos están dentro de documentos, que están anidados dentro de colecciones:

{
  "YourNerdpackUuid": {
    "collection-1": {
      "document-1-of-collection-1": "{\"lastNumber\": 42, \"another\": [1]}",
      "document-2-of-collection-1": "\"userToken\""
      // ...
    },
    "another-collection": {
      "fruits": "[\"pear\", \"apple\"]"
      // ...
    }
    // ...
  }
}

Cada nivel de NerdStorage tiene diferentes propiedades y propósitos:

Colecciones: Desde un Nerdpack, puedes crear múltiples colecciones nombrando cada una de ellas. Dentro de una colección puedes poner uno o más documentos. Piense en una colección como un almacenamiento de valor principal, donde cada documento es un par de valor principal.
Documentos: un documento consta de un identificador (documentId) y un conjunto de datos asociados a él.
Datos asociados a un documento: NerdStorage acepta cualquier tipo de datos asociados a un documentId. Los componentes de consulta y mutación que se proporcionan funcionan mediante la serialización y deseriaización de JSON.

Advertencia

NerdStorage no está cifrado. No almacene secretos, clave de API, token de acceso personal ni clave de licencia.

Límites

Un Nerdpack puede contener hasta 1000 colecciones y 10 000 documentos, además del tipo de almacenamiento.
Una colección puede contener hasta 1500 documentos, más el tipo de almacenamiento.
Cada documento puede tener una longitud máxima de 1024 KiB cuando se serializa.

Acceso a los datos

Para acceder a NerdStorage, puede ejecutar la consulta NerdGraph o emplear la consulta de almacenamiento proporcionada.

Dependiendo del almacenamiento al que desee acceder, puede emplear un conjunto diferente de componentes del SDK:

Acceso de usuario: UserStorageQuery y UserStorageMutation
Acceso a la cuenta: AccountStorageQuery y AccountStorageMutation
Acceso a la entidad: EntityStorageQuery y EntityStorageMutation

Cada uno de estos componentes puede funcionar de forma declarativa, por ejemplo, como parte de sus métodos de renderizado de React o de forma imperativa. Emplea los métodos estáticos para query y mutation.

Licencias para trabajar con NerdStorage

Para conservar los cambios en NerdStorage, como crear, actualizar y eliminar cuentas y almacenamiento de entidades, debe tener un rol de usuario con licencia para conservar los cambios.