View a markdown version of this page

Espaces clés - Amazon Keyspaces (pour Apache Cassandra)
CREATE KEYSPACEALTER KEYSPACEDROP KEYSPACEUSE

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Espaces clés

Un keyspace regroupe les tables associées qui sont pertinentes pour une ou plusieurs applications. En termes de système de gestion de base de données relationnelle (SGBDR), les keyspaces sont à peu près similaires aux bases de données, tablespaces ou constructions similaires.

Note

Dans Apache Cassandra, les keyspaces déterminent la réplique des données entre plusieurs nœuds de stockage. Amazon Keyspaces est toutefois un service entièrement géré : les détails de sa couche de stockage sont gérés en votre nom. Pour cette raison, les espaces clés d'Amazon Keyspaces sont uniquement des constructions logiques et ne sont pas liés au stockage physique sous-jacent.

Pour plus d'informations sur les limites de quota et les contraintes relatives aux espaces clés Amazon Keyspaces, consultez Quotas pour Amazon Keyspaces (pour Apache Cassandra).

Déclarations relatives aux espaces clés

CREATE KEYSPACE

Utilisez l'instruction CREATE KEYSPACE pour créer un nouveau keyspace.

Syntaxe

create_keyspace_statement ::= 
    CREATE KEYSPACE [ IF NOT EXISTS ] keyspace_name
    WITH options

Où :

  • keyspace_name est le nom du keyspace à créer.

  • Les options peuvent être les suivantes :

    • REPLICATION — Une carte qui indique la stratégie de réplication pour l'espace clé :

      • SingleRegionStrategy — Pour un espace clé à région unique. (Obligatoire)

      • NetworkTopologyStrategy — Spécifiez au moins deux Régions AWS. Le facteur de réplication pour chaque région est de trois. (Facultatif)

    • DURABLE_WRITES — Les écritures sur Amazon Keyspaces sont toujours durables, cette option n'est donc pas obligatoire. Toutefois, si elle est spécifiée, la valeur doit être true.

    • TAGS — Liste de balises de paires clé-valeur à associer à la ressource lorsque vous la créez. (Facultatif)

Exemple

Créez un keyspace comme suit.

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class': 'SingleRegionStrategy'} and TAGS ={'key1':'val1', 'key2':'val2'} ;

Pour créer un espace clé multi-régions, spécifiez NetworkTopologyStrategy et inclure au moins deux Régions AWS. Le facteur de réplication pour chaque région est de trois.

CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3'};

ALTER KEYSPACE

Vous pouvez utiliser ALTER KEYSPACE WITH déclaration pour ce qui suit options

  • REPLICATION — Utilisez cette option pour ajouter un nouveau Région AWS réplique dans un espace clé. Vous pouvez ajouter une nouvelle région à un espace clé à région unique ou à un espace de touches multi-régions.

  • TAGS — Utilisez cette option pour ajouter ou supprimer des balises d'un espace clé.

Syntaxe

alter_keyspace_statement ::= 
    ALTER KEYSPACE keyspace_name
    WITH options

Où :

  • keyspace_name est le nom du keyspace à modifier.

  • options sont l'un des suivants :

    • ADD | DROP TAGS — Une liste de balises de paires clé-valeur à ajouter ou à supprimer de l'espace clé.

    • REPLICATION — Une carte qui indique la stratégie de réplication pour l'espace clé ;

      • class— NetworkTopologyStrategy définit l'espace clé comme un espace clé multi-régions.

      • region— Spécifiez un élément supplémentaire Région AWS pour ce keyspace. Le facteur de réplication pour chaque région est de trois.

      • CLIENT_SIDE_TIMESTAMPS — La valeur par défaut est DISABLED. Vous ne pouvez modifier le statut qu'en ENABLED.

Exemples

Modifiez un espace clé comme indiqué dans l'exemple suivant pour ajouter des balises.

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

Pour ajouter une troisième région à un espace de touches multi-régions, vous pouvez utiliser l'instruction suivante.

ALTER KEYSPACE my_keyspace
WITH REPLICATION = {
    'class': 'NetworkTopologyStrategy',
    'us-east-1': '3',
    'us-west-2': '3',
    'us-west-1': '3'
} AND CLIENT_SIDE_TIMESTAMPS = {'status': 'ENABLED'};

DROP KEYSPACE

Utilisez le DROP KEYSPACE instruction pour supprimer un espace clé, y compris tout son contenu, tel que des tableaux.

Syntaxe

drop_keyspace_statement ::= 
    DROP KEYSPACE [ IF EXISTS ] keyspace_name

Où :

  • keyspace_name est le nom du keyspace à supprimer.

Exemple

DROP KEYSPACE my_keyspace;

USE

Utilisez le USE instruction pour définir l'espace clé actuel. Cela vous permet de faire référence à des objets liés à un espace clé spécifique, par exemple des tables et des types, sans utiliser le nom complet qui inclut le préfixe de l'espace clé.

Syntaxe

use_statement ::= 
    USE keyspace_name

Où :

  • keyspace_name est le nom de l'espace clé à utiliser.

Exemple

USE my_keyspace;