Opérations de balisage pour Amazon Keyspaces

Vous pouvez ajouter, répertorier, modifier ou supprimer des balises pour les espaces clés et les tables à l'aide de la console Amazon Keyspaces (pour Apache Cassandra), de laAWS CLI ou du langage de requête Cassandra (CQL). Vous pouvez ensuite activer ces balises définies par l'utilisateur afin de les faire apparaître sur la console AWS Billing and Cost Management pour le suivi de la répartition des coûts. Pour plus d'informations, veuillez consulter Rapports de répartition des coûts pour Amazon Keyspaces.

Pour la modification en bloc, vous pouvez également utiliser l'éditeur d'étiquettes sur la console. Pour plus d'informations, veuillez consulter Utilisation de Tag Editor dans le Guide de l'utilisateur AWS Resource Groups.

Ajout d'étiquettes à des tables et des espaces clés nouveaux ou existants à l'aide de la console

Vous pouvez utiliser la console Amazon Keyspaces pour ajouter des étiquettes à de nouvelles tables et de nouvelles tables lors de leur création. Vous pouvez également ajouter, répertorier, modifier ou supprimer des balises pour les tables existantes.

Pour baliser des keyspaces lors de leur création (console)

1. Connectez-vous à et ouvrezAWS Management Console la console Amazon Keyspaces à l'adresse https://console.aws.amazon.com/keyspaces/home.

2. Dans le panneau de navigation, choisissez Keyspaces, puis Créer un keyspace.

3. Dans la page Créer un keyspace indiquez un nom pour le keyspace. Entrez une clé et une valeur pour la balise, puis choisissez Ajouter une nouvelle balise.

4. Choisissez Create keyspace.

Pour baliser les tables lors de leur création (console)

1. Connectez-vous à et ouvrezAWS Management Console la console Amazon Keyspaces à l'adresse https://console.aws.amazon.com/keyspaces/home.

2. Dans le panneau de navigation, choisissez Tables, puis Create table (Créer une table).

3. Sur la page Créer une table, dans la section Détails de la table, sélectionnez un espace clé et donnez un nom à la table.

4. Dans la section Schéma, créez le schéma de votre table.

5. Dans la section Paramètres du tableau, choisissez Personnaliser les paramètres.

6. Passez à la section Tags du tableau — facultative, et choisissez Ajouter une nouvelle balise pour créer de nouvelles balises.

7. Choisissez Créer un tableau.

Pour baliser des ressources existantes (console)

1. Connectez-vous à et ouvrezAWS Management Console la console Amazon Keyspaces à l'adresse https://console.aws.amazon.com/keyspaces/home.

2. Dans le panneau de navigation, choisissez Keyspaces ou Tables.

3. Choisissez un keyspace ou une table dans la liste. Choisissez ensuite Gérer les balises pour ajouter, modifier ou supprimer vos balises.

Pour plus d'informations sur la structure des balises, consultez Restrictions de balisage pour Amazon Keyspaces.

Ajout d'étiquettes à des tables et des espaces clés nouveaux ou existants à l'aide de laAWS CLI

Les exemples de cette section montrent comment utiliser l'AWSinterface de ligne de commande pour spécifier des balises lorsque vous créez des espaces clés et des tables, comment ajouter ou supprimer des balises dans des ressources existantes et comment répertorier des balises.

L'exemple suivant montre comment créer une nouvelle table avec des étiquettes. La commande crée une table MyTable dans un espace de touches MyKeyspace déjà existant. Notez que la commande a été divisée en différentes lignes pour faciliter la lisibilité.

aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' 
            --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' 
            --tags 'key=key1,value=val1' 'key=key2,value=val2'

L'exemple suivant montre comment ajouter de nouvelles étiquettes à une table existante.

aws keyspaces tag-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable' --tags 'key=key3,value=val3' 'key=key4,value=val4'

L'exemple suivant montre comment répertorier les étiquettes de la ressource spécifiée.

aws keyspaces list-tags-for-resource --resource-arn 'arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable'

La sortie de la dernière commande ressemble à ceci.

{
    "tags": [
        {
            "key": "key1",
            "value": "val1"
        },
        {
            "key": "key2",
            "value": "val2"
        },
        {
            "key": "key3",
            "value": "val3"
        },
        {
            "key": "key4",
            "value": "val4"
        }
    ]
}

Ajout d'étiquettes à des tables et des espaces clés nouveaux ou existants à l'aide du CQL

Les exemples suivants montrent comment utiliser CQL pour spécifier des balises lorsque vous créez des keyspaces et des tables, comment baliser des ressources existantes et comment lire des balises.

L'exemple suivant crée un nouveau keyspace avec des balises.

CREATE KEYSPACE mykeyspace WITH TAGS = {'key1':'val1', 'key2':'val2'} ;
                

L'exemple suivant crée une table avec des balises.

CREATE TABLE mytable(...) WITH TAGS = {'key1':'val1', 'key2':'val2'};
                

Pour baliser les ressources dans une instruction avec d'autres commandes

CREATE KEYSPACE mykeyspace WITH REPLICATION = {'class': 'Simple Strategy'} AND TAGS = {'key1':'val1', 'key2':'val2'};
                

L'exemple suivant montre comment ajouter ou supprimer des balises sur des keyspaces et des tables existants.

ALTER KEYSPACE mykeyspace ADD TAGS {'key1':'val1', 'key2':'val2'};

ALTER TABLE mytable DROP TAGS {'key1':'val1', 'key2':'val2'};

Pour lire les balises attachées à une ressource, utilisez l'instruction CQL suivante.

SELECT * FROM system_schema_mcs.tags WHERE valid_where_clause;

La clause WHERE est obligatoire et doit avoir l'un des formats suivants :

• keyspace_name = 'mykeyspace' AND resource_type = 'keyspace'

• keyspace_name = 'mykeyspace' AND resource_name = 'mytable'

• resource_id = arn

Exemples :

La requête suivante indique si un keyspace comporte des balises.

SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_type = 'keyspace';

La sortie de la commande ressemble à ce qui suit.

resource_id                                                      | keyspace_name | resource_name | resource_type | tags
-----------------------------------------------------------------+---------------+---------------+---------------+------
arn:aws:cassandra:us-east-1:123456789:/keyspace/mykeyspace/      | mykeyspace    | mykeyspace    | keyspace      | {'key1': 'val1', 'key2': 'val2'}
            
        

La requête suivante affiche les balises d'une table.

SELECT * FROM system_schema_mcs.tags WHERE keyspace_name = 'mykeyspace' AND resource_name = 'mytable';

La sortie de cette requête se présente comme suit :

resource_id                                                                 | keyspace_name | resource_name | resource_type | tags
----------------------------------------------------------------------------+---------------+---------------+---------------+------
arn:aws:cassandra:us-east-1:123456789:/keyspace/mykeyspace/table/mytable    | mykeyspace    | mytable       | table         | {'key1': 'val1', 'key2': 'val2'}