AWS::DynamoDB::Table GlobalSecondaryIndex

Représente les propriétés d'un index secondaire global.

Syntaxe

Pour déclarer cette entité dans votre AWS CloudFormation modèle, utilisez la syntaxe suivante :

JSON

{
  "ContributorInsightsSpecification" : ContributorInsightsSpecification,
  "IndexName" : String,
  "KeySchema" : [ KeySchema, ... ],
  "OnDemandThroughput" : OnDemandThroughput,
  "Projection" : Projection,
  "ProvisionedThroughput" : ProvisionedThroughput
}

YAML

  ContributorInsightsSpecification: 
    ContributorInsightsSpecification
  IndexName: String
  KeySchema: 
    - KeySchema
  OnDemandThroughput: 
    OnDemandThroughput
  Projection: 
    Projection
  ProvisionedThroughput: 
    ProvisionedThroughput

Propriétés

ContributorInsightsSpecification

Les paramètres utilisés pour activer ou désactiver CloudWatch Contributor Insights pour l'index secondaire global spécifié.

Obligatoire : non

Type : ContributorInsightsSpécification

Requis pour la mise à jour : aucune interruption

IndexName

Le nom de l'index secondaire global. Le nom doit être unique parmi tous les autres index de cette table.

Obligatoire : oui

Type : chaîne

Modèle : [a-zA-Z0-9_.-]+

Minimum : 3

Maximum : 255

Requis pour la mise à jour : les mises à jour ne sont pas prises en charge.

KeySchema

Schéma complet de la clé pour l'index secondaire global, qui se compose d'une ou de plusieurs paires de noms d'attributs et de types de clés :

• HASH – Clé de partition

• RANGE – Clé de tri

Note

La clé de partition d'un élément est également appelée attribut de hachage. Le terme « attribut de hachage » dérive de l'utilisation par DynamoDB d'une fonction de hachage interne pour répartir uniformément les éléments de données entre les partitions, en fonction de leurs valeurs de clé de partition.

La clé de tri d'un élément est également appelée attribut de plage. Le terme « attribut de plage » dérive de la façon dont DynamoDB stocke les éléments avec la même clé de partition physiquement proches les uns des autres, dans l'ordre de la valeur de la clé de tri.

Obligatoire : oui

Type : Tableau de KeySchema

Minimum : 1

Maximum : 2

Requis pour la mise à jour : les mises à jour ne sont pas prises en charge.

OnDemandThroughput

Le nombre maximal d'unités de lecture et d'écriture pour l'index secondaire global spécifié. Si vous utilisez ce paramètre, vous devez le spécifier MaxReadRequestUnitsMaxWriteRequestUnits, ou les deux.

Obligatoire : non

Type : OnDemandDébit

Requis pour la mise à jour : aucune interruption

Projection

Représente les attributs qui sont copiés (projetés) dans l'index secondaire global à partir de la table. Ils s'ajoutent aux attributs de clé principaux et aux attributs de clé d'index, lesquels sont automatiquement projetés.

Obligatoire : oui

Type : Projection

Requis pour la mise à jour : les mises à jour ne sont pas prises en charge.

ProvisionedThroughput

Représente les paramètres de débit alloué pour l'index secondaire global spécifié.

Pour connaître les valeurs de débit provisionné minimum et maximum actuelles, veuillez consulter Quotas de service, compte et table dans le Manuel du développeur Amazon DynamoDB.

Obligatoire : non

Type : ProvisionedThroughput

Requis pour la mise à jour : aucune interruption