Introdução ao NerdStorage

Para ajudá-lo a criar um aplicativo New Relic, fornecemos o SDK New Relic One. Nesta página, você aprenderá como usar os componentes do NerdStorage SDK.

Use NerdStorage em seus aplicativos

Você pode usar o NerdStorage para armazenar e recuperar conjuntos simples de dados, incluindo configurações e preferências de configuração do usuário, como favoritos, ou qualquer outro pequeno conjunto de dados. Este armazenamento é exclusivo por Nerdpack e não pode ser compartilhado com nenhum outro Nerdpack.

NerdStorage se enquadra em três categorias:

• Armazenamento do usuário: dados anexados a um usuário específico. Se você estiver autenticado como o usuário ao qual os dados estão anexados, poderá lê-los e gravá-los.
• Armazenamento de conta: dados anexados a uma conta específica. Se você estiver autenticado e puder acessar a conta, poderá ler e gravar no NerdStorage com escopo definido na conta. A visibilidade dos dados da conta também é determinada pelas regras da conta mestra ou da subconta: se um usuário tiver acesso à conta mestra, ele também terá acesso aos dados de todas as subcontas.
• Armazenamento de entidade: dados anexados a uma determinada entidade. Se você puder ver a entidade correspondente, poderá ler e gravar dados nessa entidade.

Modelo de dados

Você pode imaginar o NerdStorage como um mapa principal de valor aninhado. Os dados estão dentro de documentos, que estão aninhados em coleções:

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

Cada nível do NerdStorage tem propriedades e finalidades diferentes:

• Coleções: A partir de um Nerdpack, você pode criar múltiplas coleções nomeando cada uma delas. Dentro de uma coleção você pode colocar um ou mais documentos. Pense em uma coleção como um armazenamento de valor principal, onde cada documento é um par de valor principal.
• Documentos: um documento consiste em um identificador (documentId) e um conjunto de dados associados a ele.
• Dados associados a um documento: NerdStorage aceita qualquer tipo de dados associados a um documentId. Os componentes de consulta e mutação fornecidos funcionam serializando e desserializando JSON.

Limites

• Um Nerdpack pode conter até 1.000 coleções e 10.000 documentos, além do tipo de armazenamento.
• Uma coleção pode conter até 1.500 documentos, além do tipo de armazenamento.
• Cada documento pode ter um comprimento máximo de 1.024 KiB quando serializado.

Acesso de dados

Para acessar o NerdStorage, você pode executar a consulta NerdGraph ou usar a consulta de armazenamento fornecida.

Dependendo de qual armazenamento você deseja acessar, você pode usar um conjunto diferente de componentes do SDK:

• Acesso do usuário: UserStorageQuery e UserStorageMutation
• Acesso à conta: AccountStorageQuery e AccountStorageMutation
• Acesso à entidade: EntityStorageQuery e EntityStorageMutation

Cada um desses componentes pode operar de forma declarativa, por exemplo, como parte de seus métodos de renderização do React ou imperativamente. Ele usa os métodos estáticos para query e mutation.

Permissões para trabalhar com NerdStorage

Para persistir alterações no NerdStorage, como criação, atualização e exclusão de conta e armazenamento de entidade, você deve ter um perfil do usuário com permissão para persistir alterações.