Introduction à NerdStorage

Pour vous aider à créer une application New Relic, nous vous fournissons le SDK New Relic](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk). Sur cette page, vous apprendrez à utiliser les composants du SDK NerdStorage.

Utilisez NerdStorage dans vos applications

Vous pouvez utiliser NerdStorage pour stocker et récupérer des ensembles de données simples, y compris les paramètres configuration et les préférences de l'utilisateur, comme les favoris, ou tout autre petit ensemble de données. Ce stockage est unique par Nerdpack et ne peut être partagé avec aucun autre Nerdpack.

NerdStorage se divise en trois catégories :

Stockage utilisateur: Données attachées à un utilisateur particulier. Si vous êtes authentifié en tant qu'utilisateur auquel les données sont attachées, vous pouvez les lire et les écrire.
Stockage de compte: Données attachées à un compte particulier. Si vous êtes authentifié et pouvez accéder au compte, vous pouvez lire et écrire sur le compte NerdStorage. La visibilité des données du compte est également déterminée par les règles du compte principal ou du sous-compte : si un utilisateur a accès au compte principal, il a également accès aux données de tous les sous-comptes.
Stockage d'entité: Données attachées à une entité particulière. Si vous pouvez voir l’entité correspondante, vous pouvez lire et écrire des données sur cette entité.

Modèle de données

Vous pouvez imaginer NerdStorage comme une carte valeur-clé imbriquée. Les données se trouvent dans des documents, qui sont imbriqués dans des collections :

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

Chaque niveau de NerdStorage a des propriétés et un objectif différents :

Collections: À partir d'un Nerdpack, vous pouvez créer plusieurs collections en nommant chacune d'elles. À l'intérieur d'une collection, vous pouvez mettre un ou plusieurs documents. Considérez une collection comme un stockage à valeur clé, où chaque document est une paire de valeur clé.
Documents: Un document est constitué d'un identifiant (documentId) et d'un ensemble de données qui lui sont associées.
Données associées à un document : NerdStorage accepte tout type de données associées à un documentId. Les composants de requête et de mutation fournis fonctionnent en sérialisant et en désérialisant JSON.

Prudence

NerdStorage n'est pas crypté. Ne stockez pas de secrets, de clé API, de jeton d'accès personnel ou de clé de licence.

Limites

Un Nerdpack peut contenir jusqu'à 1 000 collections et 10 000 documents, plus le type de stockage.
Une collection peut contenir jusqu'à 1 500 documents, plus le type de stockage.
Chaque document peut avoir une longueur maximale de 1024 Ko lorsqu'il est sérialisé.

Accès aux données

Pour accéder à NerdStorage, vous pouvez exécuter la requête NerdGraph ou utiliser la requête de stockage fournie.

Selon le stockage auquel vous souhaitez accéder, vous pouvez utiliser un ensemble différent de composants SDK :

Accès utilisateur: UserStorageQuery et UserStorageMutation
Accès au compte: AccountStorageQuery et AccountStorageMutation
Accès à l'entité: EntityStorageQuery et EntityStorageMutation

Chacun de ces composants peut fonctionner de manière déclarative, par exemple, dans le cadre de vos méthodes de rendu React ou de manière impérative. Il utilise les méthodes statiques pour query et mutation.

Autorisations pour travailler avec NerdStorage

Afin de conserver les modifications sur NerdStorage, telles que la création, la mise à jour et la suppression de comptes et d'entités de stockage, vous devez disposer d'un rôle d'utilisateur avec l'autorisation de conserver les modifications.