Gérer les tables de données à l'aide de l'interface de ligne de commande - Tablestore

Prérequis

Une installation de la CLI Tablestore avec des identifiants d'accès configurés. Pour plus d'informations, consultez la rubrique CLI Tablestore.
Une instance Tablestore. Pour plus d'informations, consultez la rubrique Opérations sur les instances.

Créer une table

Pour créer une table de données, spécifiez les colonnes de clé primaire et configurez éventuellement la durée de conservation des données (TTL) ainsi que les limites de version. Vous pouvez également créer une table à partir d'un fichier de configuration JSON.

create -t tableName --pk '[{"c":"col1","t":"string"},{"c":"col2","t":"integer"}]' [--ttl seconds] [--version max]

Paramètre	Obligatoire	Description
`-t, --table`	Oui	Le nom de la table de données.
`-k, --pk`	Oui	Les définitions des colonnes de clé primaire au format de tableau JSON. Chaque élément contient les champs suivants : `c` (obligatoire) : le nom de la colonne de clé primaire. `t` (obligatoire) : le type de la colonne de clé primaire. Valeurs valides : `string`, `integer`, `binary`. `opt` (facultatif) : valeur par défaut `none`. Définissez ce paramètre sur `auto` pour utiliser la colonne comme clé primaire auto-incrémentielle. Pour plus d'informations sur les colonnes de clé primaire auto-incrémentielles, consultez la rubrique Colonne de clé primaire auto-incrémentielle. Remarque Il n'est pas nécessaire de définir les colonnes d'attribut lors de la création d'une table de données. Chaque ligne dans Tablestore peut comporter des colonnes d'attribut différentes. Les noms des colonnes d'attribut sont spécifiés lors de l'écriture des données. Une table de données prend en charge jusqu'à 4 colonnes de clé primaire. La première colonne de clé primaire sert de clé de partition par défaut. Les configurations de clé primaire ne peuvent pas être modifiées après la création de la table.
`-m, --model`	Non	Le type de table. Valeur par défaut : `widecolumn` (table de données). Pour créer une table de séries temporelles, consultez la rubrique Modèle TimeSeries.
`--ttl`	Non	La durée de conservation des données (TTL), en secondes. Valeur par défaut : `-1` (les données n'expirent jamais). La valeur doit être supérieure ou égale à 86 400 (un jour) ou égale à -1.
`--version`	Non	Le nombre maximal de versions. Valeur par défaut : `1`. La valeur doit être un entier non nul. Important Tablestore n'impose pas de limite stricte au nombre maximal de versions. Toutefois, pour des performances et une utilisation optimales, maintenez cette valeur à 500 ou moins.
`--read_cu`	Non	Le débit de lecture ou d'écriture réservé, en unités de capacité (CU). Valeur par défaut : `0` (paiement à l'utilisation). Remarque Cette configuration est prise en charge uniquement pour les tables de données dans les instances haute performance. Si le débit de lecture ou d'écriture réservé est défini sur une valeur non nulle, vous êtes facturé indépendamment de l'envoi ou non de requêtes de lecture ou d'écriture.
`--write_cu`	Non
`-d, --defined`	Non	Colonnes prédéfinies au format de tableau JSON. Requis pour les index secondaires. Chaque élément contient les champs suivants : `c` (obligatoire) : le nom de la colonne prédéfinie. `t` (obligatoire) : le type de la colonne prédéfinie. Valeurs valides : `string`, `integer`, `binary`, `double`, `bool`. Remarque Une table de données prend en charge jusqu'à 32 colonnes prédéfinies par défaut.
`--stream_enable`	Non	Indique s'il faut activer Stream. Valeur par défaut : `false`.
`--stream_expire`	Non	La période d'expiration des données Stream, en heures. Valeur par défaut : `24`.
`-i, --input`	Non	Le chemin d'accès à un fichier de configuration JSON pour la création de la table.

Créez une table de données de base :

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]'

Créez une table de données avec une colonne auto-incrémentielle et une durée de conservation (TTL) :

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer","opt":"auto"}]' --ttl 864000 --version 1

Créez une table de données avec des colonnes prédéfinies pour les index secondaires :

create -t mytable --pk '[{"c":"uid","t":"string"},{"c":"pid","t":"integer"}]' --defined '[{"c":"name","t":"string"},{"c":"age","t":"integer"}]'

Créez une table de données à partir d'un fichier de configuration :

Windows

create -i D:\\localpath\\filename.json

Linux et macOS

create -i /localpath/filename.json

Exemple de fichier de configuration :

{
    "Name": "mytable",
    "Meta": {
        "Pk": [
            {"C": "uid", "T": "string", "Opt": "none"},
            {"C": "pid", "T": "integer", "Opt": "none"}
        ]
    },
    "Option": {
        "TTL": 864000,
        "Version": 3
    },
    "CU": {
        "Read": 0,
        "Write": 0
    }
}

Sélectionner une table

Sélectionnez une table de données pour les opérations de données ultérieures.

use --wc -t tableName

Paramètre

Obligatoire

Description

--wc

Non

Sélectionne une table de données à colonnes larges.

-t, --table

Oui

Le nom de la table.

Exemple :

use --wc -t mytable

Lister les noms de tables

Répertoriez les noms des tables dans l'instance actuelle. Filtrez les résultats par type de table si nécessaire.

list [--wc | --all] [--detail]

Paramètre

Obligatoire

Description

-w, --wc

Non

Répertorie uniquement les tables de données.

-a, --all

Non

Répertorie tous les types de tables.

-d, --detail

Non

Affiche les informations détaillées sur la table.

Exemple :

list --wc

Consulter les détails d'une table

Consultez les détails de configuration d'une table de données ou d'une table d'index.

desc [-t tableName] [-f json|table] [-o outputFile]

Paramètre

Obligatoire

Description

-t, --table

Non

Le nom de la table de données ou de la table d'index. Si omis, la valeur par défaut correspond à la table sélectionnée par use.

-f, --print_format

Non

Le format de sortie. Valeurs valides : json (par défaut) et table.

-o, --output

Non

Enregistre la sortie dans un fichier local.

Exemple :

desc -t mytable

Mettre à jour une table

Mettez à jour la configuration d'une table de données, telle que la durée de conservation des données (TTL), le nombre maximal de versions et le débit réservé.

alter -t tableName [--ttl seconds] [--version max] [--read_cu n] [--write_cu n]

Paramètre	Obligatoire	Description
`-t, --table`	Oui	Le nom de la table. Si une table est sélectionnée avec `use`, ce paramètre est facultatif.
`--ttl`	Non	La durée de conservation des données (TTL), en secondes. La valeur doit être supérieure ou égale à 86 400 (un jour) ou égale à -1 (les données n'expirent jamais).
`--version`	Non	Le nombre maximal de versions. La valeur doit être un entier non nul.
`--read_cu`	Non	Le débit de lecture ou d'écriture réservé, en unités de capacité (CU). Cette configuration est prise en charge uniquement pour les instances haute performance.
`--write_cu`	Non
`--stream_enable`	Non	Indique s'il faut activer Stream.
`--stream_expire`	Non	La période d'expiration des données Stream, en heures.
`--disallow_update`	Non	Indique s'il faut désactiver les opérations de mise à jour.

Définissez la durée de conservation (TTL) sur un jour et le nombre maximal de versions sur 1 :

alter -t mytable --ttl 86400 --version 1

Supprimer une table

Supprimez une table de données spécifiée.

drop -t tableName [-y]

Paramètre

Obligatoire

Description

-t, --table

Oui

Le nom de la table.

-y, --yes

Non

Ignorer l'invite de confirmation et supprimer directement la table.

Exemple :

drop -t mytable -y