AnalyticDB:Index JSON

Prérequis de version

Pour afficher ou mettre à jour la version mineure de votre cluster, accédez à la console AnalyticDB for MySQL, ouvrez la page Cluster Information et repérez la section Configuration Information.

Choisir le type d'index approprié

Chaque index JSON ou index de tableau JSON couvre une seule colonne JSON. Pour indexer plusieurs colonnes, créez un index distinct pour chacune.

Remarques sur l'utilisation

• Les index JSON et les index de tableau JSON ne peuvent être créés que sur des colonnes de type JSON.

• Les index de tableau JSON prennent uniquement en charge les éléments numériques et les chaînes. Les tableaux et objets imbriqués ne peuvent pas être indexés.

• Pour les clusters exécutant la version V3.1.5.10 ou ultérieure, les index JSON ne sont pas créés automatiquement lors de la création d'une table. Créez-les manuellement à l'aide de la syntaxe ci-dessous.

• Pour les clusters exécutant des versions antérieures à V3.1.5.10, les index JSON sont créés automatiquement pour les colonnes JSON après la création de la table.

Créer un index JSON

Tous les exemples de cette section utilisent une table devices qui stocke la télémétrie des appareils au format JSON :

CREATE TABLE devices(
  id int,
  info json,
  ...
)
DISTRIBUTED BY HASH(id);

Une valeur info typique se présente comme suit :

{"device_id": "d-001", "status": "online", "tags": ["prod", "us-west"]}

CREATE TABLE table_name(
  column_name column_type,
  {INDEX|KEY} [index_name](column_name|column_name->'$.json_path')
)
DISTRIBUTED BY HASH(column_name)

CREATE TABLE devices(
  id int,
  info json,
  index idx_info(info)
)
DISTRIBUTED BY HASH(id);

CREATE TABLE devices(
  id int,
  info json,
  index idx_info_status(info->'$.status')
)
DISTRIBUTED BY HASH(id);

ALTER TABLE db_name.table_name ADD {INDEX|KEY} [index_name] (column_name|column_name->'$.json_path',...)

ALTER TABLE devices ADD KEY idx_info(info);

ALTER TABLE devices ADD KEY idx_info_status(info->'$.status');

Créer un index de tableau JSON

Les index de tableau JSON accélèrent les requêtes d'appartenance sur les tableaux JSON à l'aide des fonctions JSON_CONTAINS et JSON_OVERLAPS. Ce type d'index nécessite la version V3.1.10.6 ou ultérieure.

L'expression JSONPath $[*] correspond à tous les éléments d'un tableau JSON.

Les index de tableau JSON prennent uniquement en charge les éléments de tableau numériques et les chaînes. Les tableaux et objets imbriqués ne peuvent pas être indexés.

CREATE TABLE table_name(
  column_name column_type,
  {INDEX|KEY} [index_name](column_name->'$[*]')
)
DISTRIBUTED BY HASH(column_name);

CREATE TABLE devices(
  id int,
  info json,
  index idx_info_tags(info->'$[*]')
)
DISTRIBUTED BY HASH(id);

ALTER TABLE db_name.table_name ADD {INDEX|KEY} [index_name] (column_name->'$[*]')

ALTER TABLE devices ADD KEY idx_info_tags(info->'$[*]');

Supprimer un index

ALTER TABLE db_name.table_name DROP KEY index_name

SHOW INDEX FROM db_name.table_name;

ALTER TABLE mydb.devices DROP KEY idx_info;

ALTER TABLE mydb.devices DROP KEY idx_info_tags;

Étapes suivantes

• JSON : Référence du type de données JSON pour AnalyticDB for MySQL.

• Fonctions JSON : Fonctions JSON prises en charge par AnalyticDB for MySQL, y compris JSON_CONTAINS et JSON_OVERLAPS.