Index et partitionnement géographique

Spanner propose plusieurs types d'index pour améliorer les performances des requêtes. Il est essentiel de choisir le type d'index adapté à votre schéma et à vos schémas de requête, en particulier pour les bases de données qui utilisent le partitionnement géographique. Cette page décrit les avantages des différents types d'index et les bonnes pratiques pour sélectionner et utiliser des index Spanner avec le partitionnement géographique.

Types d'index

Spanner est compatible avec les index globaux, locaux et distants. Chaque type présente des caractéristiques de performances et des cas d'utilisation différents. Pour les bases de données géopartitionnées, il est important de comprendre ces types d'index. Choisir le bon index vous aide à optimiser le schéma et les requêtes de votre base de données, ce qui peut améliorer considérablement la latence de votre base de données partitionnée géographiquement. Pour les bases de données qui n'utilisent pas le partitionnement géographique, il est moins important de comprendre ces types d'index, car ils sont tous stockés dans l'emplacement par défaut et présentent des caractéristiques de performances similaires.

Index globaux

Un index global est le type d'index par défaut dans Spanner. Les données d'index sont stockées dans la partition par défaut, qui peut ne pas être colocalisée avec les données de la table. La création d'index globaux sur des tables partitionnées géographiquement peut entraîner des latences d'écriture nettement plus élevées pour les écritures impliquant les colonnes indexées, en particulier si le quorum d'écriture de la partition par défaut pour l'index est éloigné du quorum d'écriture des lignes de la table dans lesquelles l'écriture est effectuée. Vous pouvez réduire les latences de lecture des index globaux en utilisant des instances dupliquées en lecture seule à proximité, ainsi que des régions de baux de lecture ou des lectures non actualisées.

Les index globaux présentent les caractéristiques suivantes :

  • Ils accélèrent les requêtes qui nécessiteraient autrement une analyse complète de la table et appliquent l'unicité à toutes les lignes de la table, quel que soit l'emplacement.
  • Ils conviennent aux colonnes qui nécessitent des valeurs uniques dans une base de données.
  • Ils accélèrent les requêtes qui filtrent ou trient par colonnes indexées.

Voici un exemple d'index unique global :

CREATE UNIQUE INDEX idx_customer_email ON customer(email);

Index locaux

Un index local est entrelacé dans la hiérarchie parente de la table indexée. Les noms et les types des colonnes de clé primaire doivent correspondre à la table indexée.

Les index locaux présentent les caractéristiques suivantes :

  • Ils stockent les données d'index dans la même partition que les données indexées. La latence d'écriture est soumise au quorum d'écriture de l'emplacement particulier, et non au quorum d'écriture de l'emplacement par défaut.

  • Ils offrent la latence la plus faible pour les requêtes ciblant un préfixe de clé spécifique, car l'index et les données de la table sont colocalisés au même emplacement.

Pour créer un index local, intercalez l'index dans la table parente. Si vous utilisez un index local UNIQUE, l'unicité n'est appliquée que dans une ligne parente particulière, et non dans l'ensemble de la table.

L'exemple suivant crée un index local sur la table customer, entrelacée dans la table parent locations :

GoogleSQL

-- Create locations placement table
CREATE TABLE locations (
  location STRING(MAX) NOT NULL PLACEMENT KEY,
) PRIMARY KEY(location);

-- Create customer table interleaved in the locations table
CREATE TABLE customer (
  location STRING(MAX) NOT NULL,
  customerId  INT64 NOT NULL,
  email STRING(MAX),
  webcookie STRING(64),
) PRIMARY KEY(location, customerId), INTERLEAVE IN PARENT locations;

-- Create a local index on the interleaved customer table
CREATE INDEX idx_customer_email_local ON customer(location, email),
INTERLEAVE IN locations;

PostgreSQL

-- Create locations placement table
CREATE TABLE locations (
  location varchar NOT NULL PLACEMENT KEY PRIMARY KEY
);

-- Create customer table interleaved in the locations table
CREATE TABLE customer (
  location varchar NOT NULL,
  customerId  BIGINT NOT NULL,
  email varchar(1024),
  webcookie varchar(64),
  PRIMARY KEY(location, customerId)
) INTERLEAVE IN PARENT locations;

-- Create a local index on the interleaved customer table
CREATE INDEX idx_customer_email_local ON customer(location, email)
INTERLEAVE IN locations;

Lorsque vous interrogez des données dans une transaction en lecture-écriture, vous devez spécifier le préfixe de clé primaire de la table indexée dans la requête. Sinon, la requête peut nécessiter une analyse complète de la table. Exemple :

GoogleSQL

-- The location (the index key prefix) must be specified
SELECT *
FROM customer
WHERE location = @location AND email = @email;

PostgreSQL

-- The location (the index key prefix) must be specified
SELECT *
FROM customer
WHERE location = @location AND email = @email;

Pour en savoir plus sur l'optimisation qui ne nécessite pas de spécifier l'emplacement, consultez Index unique global avec un index local ou distant.

Un index local est également utile lorsque la table de placement est basée sur des entités et que vous souhaitez indexer des données dans une entité ou une sous-entité particulière. Exemple :

GoogleSQL

-- Create entity based customer placement table
CREATE TABLE customer (
  customerId INT64 NOT NULL,
  email STRING(MAX),
  webcookie STRING(64),
  location STRING(MAX) NOT NULL PLACEMENT KEY
) PRIMARY KEY(customerId);

-- Create customerOrders child table
CREATE TABLE customerOrders (
  customerId INT64 NOT NULL,
  orderId INT64 NOT NULL,
  orderName STRING(MAX) NOT NULL
) PRIMARY KEY(customerId, orderId), INTERLEAVE IN PARENT customer;

-- Create a local index on the interleaved child table
CREATE INDEX idx_order_local ON customerOrders(customerId, orderName),
INTERLEAVE IN customer;

PostgreSQL

-- Create entity based customer placement table
CREATE TABLE customer (
  customerId BIGINT NOT NULL PRIMARY KEY,
  email varchar(1024),
  webcookie varchar(64),
  location varchar NOT NULL PLACEMENT KEY
);

-- Create customerOrders child table
CREATE TABLE customerOrders (
  customerId BIGINT NOT NULL,
  orderId BIGINT NOT NULL,
  orderName varchar(1024) NOT NULL,
  PRIMARY KEY(customerId, orderId)
) INTERLEAVE IN PARENT customer;

-- Create a local index on the interleaved child table
CREATE INDEX idx_order_local ON customerOrders(customerId, orderName)
INTERLEAVE IN customer;

Index distants

Un index distant entrelace les données d'index sous une table qui n'est pas un ancêtre dans la hiérarchie d'entrelacement de la table indexée. Les types de clés primaires doivent correspondre aux types des colonnes d'index correspondantes, mais les noms peuvent être différents.

Avec le partitionnement géographique, vous ne pouvez intercaler un index distant que sous la table de placement racine gérée automatiquement. Lorsque vous activez l'option de base de données de la table d'emplacement racine (auto_managed_root_placement_table_name), Spanner crée une table interne et la remplit avec une ligne pour chaque emplacement de votre base de données. Vous pouvez utiliser cette table comme racine d'entrelacement pour les index de table d'emplacement, de sorte que les entrées d'index utilisent le même emplacement que les lignes correspondantes. Cela permet à Spanner d'effectuer des recherches d'index locales à la partition au lieu de récupérer des entrées d'index à partir de régions plus éloignées.

Les index distants présentent les caractéristiques suivantes :

  • Ils stockent les données d'index dans la partition d'instance, de la même manière que les index locaux.
  • Ils sont particulièrement utiles lorsque la clé primaire de votre table n'est pas précédée d'une clé d'emplacement, par exemple lorsqu'un ID d'entité est la clé primaire, et que vous souhaitez colocaliser géographiquement les partitions de l'index en fonction de la clé d'emplacement.
  • Ils ne sont compatibles qu'avec l'indexation des colonnes de la table de placement, et non avec les colonnes des tables enfants entrelacées.

Pour utiliser des index distants avec le partitionnement géographique, activez l'option de base de données de la table d'emplacement racine et créez un index distant entrelacé dans cette table :

  1. Utilisez l'instruction LDD ALTER DATABASE pour définir l'option auto_managed_root_placement_table_name et créer une table d'emplacement racine. Vous devez définir cette option dans une instruction ALTER DATABASE après avoir créé la base de données. Une fois cette option définie, vous ne pouvez plus renommer ni désactiver la table d'emplacement racine.

    GoogleSQL

    ALTER DATABASE DATABASE_NAME SET OPTIONS
      (auto_managed_root_placement_table_name="TABLE_NAME");
    

    Remplacez les éléments suivants :

    • DATABASE_NAME : nom de votre base de données.
    • TABLE_NAME : nom de la table à créer. Nous vous recommandons d'utiliser le nom root_placement_table.

    Par exemple, l'instruction suivante crée une table appelée root_placement_table :

    ALTER DATABASE example_db SET OPTIONS
      (auto_managed_root_placement_table_name='root_placement_table');
    

    Une fois que vous avez créé la table d'emplacement racine, Spanner crée une table interne avec la définition suivante, puis insère et supprime automatiquement des lignes lorsque vous créez ou supprimez un emplacement. Vous n'avez pas besoin de créer cette table vous-même.

    -- This table is automatically created and populated with one row per placement.
    -- Don't run this statement.
    CREATE TABLE root_placement_table (
      location STRING(MAX) NOT NULL PLACEMENT KEY
    ) PRIMARY KEY (location);
    

    PostgreSQL

    ALTER DATABASE DATABASE_NAME SET
      spanner.auto_managed_root_placement_table_name='TABLE_NAME';
    

    Remplacez les éléments suivants :

    • DATABASE_NAME : nom de votre base de données.
    • TABLE_NAME : nom de la table à créer. Nous vous recommandons d'utiliser le nom root_placement_table.

    Par exemple, l'instruction suivante crée une table appelée root_placement_table :

    ALTER DATABASE example_db SET
      spanner.auto_managed_root_placement_table_name='root_placement_table';
    

    Une fois que vous avez créé la table d'emplacement racine, Spanner crée une table interne avec la définition suivante, puis insère et supprime automatiquement des lignes lorsque vous créez ou supprimez un emplacement. Vous n'avez pas besoin de créer cette table vous-même.

    -- This table is automatically created and populated with one row per placement.
    -- Don't run this statement.
    CREATE TABLE root_placement_table (
      location varchar NOT NULL PLACEMENT KEY,
      PRIMARY KEY (location)
    );
    
  2. Créez un index distant entrelacé sous la table root_placement_table gérée automatiquement. Lorsque vous définissez l'index sur la colonne de clé d'emplacement et la colonne que vous souhaitez indexer, vous devez d'abord lister la colonne de clé d'emplacement.

    GoogleSQL

    -- Create a customer table with a primary key that is not the location
    CREATE TABLE customer (
      customerId INT64 NOT NULL,
      email STRING(MAX),
      webcookie STRING(64),
      location STRING(MAX) NOT NULL PLACEMENT KEY,
    ) PRIMARY KEY(customerId);
    
    -- Create a remote index on the customer table
    CREATE INDEX idx_customer_email_remote ON customer(location, email),
    INTERLEAVE IN root_placement_table;
    

    PostgreSQL

    -- Create a customer table with a primary key that is not the location
    CREATE TABLE customer (
      customerId BIGINT NOT NULL PRIMARY KEY,
      email varchar(1024),
      webcookie varchar(64),
      location varchar NOT NULL PLACEMENT KEY
    );
    
    -- Create a remote index on the customer table
    CREATE INDEX idx_customer_email_remote ON customer(location, email)
    INTERLEAVE IN root_placement_table;
    
  3. Lorsque vous interrogez des données dans une transaction en lecture-écriture ou lorsque l'emplacement est connu au moment de la requête, spécifiez le préfixe de clé de l'index (la colonne de clé d'emplacement) dans le prédicat de la requête afin d'éviter une analyse complète de la table. Si le client se trouve dans la même région que l'une des instances répliquées de l'emplacement spécifié, la requête s'exécute avec un accès aux données local de la partition. Exemple :

    GoogleSQL

    -- Specify the location (the index key prefix) in the query
    SELECT *
    FROM customer
    WHERE location = @location AND email = @email;
    

    PostgreSQL

    -- Specify the location (the index key prefix) in the query
    SELECT *
    FROM customer
    WHERE location = @location AND email = @email;
    

    Si l'emplacement de l'emplacement est inconnu au moment de la requête et que la colonne indexée est unique pour tous les emplacements, vous pouvez combiner un index unique global avec un index distant afin de ne pas avoir à spécifier l'emplacement dans la clause WHERE. Pour en savoir plus, consultez Index unique global avec un index local ou distant.

Optimisations pour les index uniques globaux

Lorsque vous utilisez un index unique global, Spanner peut déclencher des améliorations de la latence des requêtes avec des optimisations basées sur l'heuristique dans les cas d'utilisation suivants :

  • Lorsque vous utilisez un index unique global avec un index local ou distant
  • Lorsque vous utilisez un index unique global avec des clés primaires partielles

Les sections suivantes décrivent comment Spanner peut appliquer des optimisations dans chaque cas d'utilisation.

Index unique global avec un index local ou distant

Pour améliorer la latence des requêtes locales, Spanner peut lancer une optimisation basée sur l'heuristique lorsqu'un index unique global est combiné à un index local ou distant.

Cette optimisation réduit la latence des requêtes intrarégionales, même lorsque l'emplacement des données partitionnées géographiquement n'est pas spécifié, en devinant que l'emplacement est le même que celui du client et en contournant la partition par défaut de l'index global, ou en éliminant la nécessité d'effectuer des analyses de table complètes filtrées. Cette approche est particulièrement avantageuse lorsque les clients accèdent principalement à des données stockées dans leur propre région.

L'utilisation d'une combinaison de différents types d'index est utile si la latence des requêtes intrarégionales est la principale préoccupation, et que vous pouvez tolérer une augmentation de la latence d'écriture et des coûts de stockage supplémentaires pour l'index global. La combinaison de différents types d'index améliore également les performances des requêtes intrarégionales, même lorsque vous ne spécifiez pas l'emplacement dans votre requête.

Cette optimisation nécessite de créer un index unique global et un index local ou distant correspondant sur la même colonne. Les données indexées doivent être uniques au niveau mondial, ce qui indique à l'optimiseur de requêtes qu'il n'existe qu'une seule entrée d'index pour chaque valeur unique de la colonne. Spanner applique cette optimisation à votre requête si les conditions suivantes sont remplies :

  • Vous ne connaissez pas le préfixe de la clé primaire et vous ne spécifiez pas l'emplacement des données.
  • Votre requête provient de la même région que le leader par défaut de l'emplacement des données, qui contient le segment d'index local ou distant.

Spanner applique l'optimisation de la manière suivante :

  • Si l'optimisation est déclenchée et que la ligne est trouvée dans l'emplacement local : étant donné l'index unique global, l'optimiseur de requête évalue d'abord la requête à l'aide du segment local de l'index et n'a pas besoin de rechercher d'autres emplacements. Votre requête présente une latence intrarégionale.
  • Si la recherche d'emplacement initiale ne renvoie pas de ligne : cela indique qu'il ne s'agit pas d'une requête intra-régionale. L'optimiseur de requête se rabat sur l'index global.

L'exemple suivant crée un index unique global et un index local :

GoogleSQL

CREATE UNIQUE INDEX idx_customer_email ON customer(email);
CREATE INDEX idx_customer_email_local ON customer(location, email), INTERLEAVE IN locations;

PostgreSQL

CREATE UNIQUE INDEX idx_customer_email ON customer(email);
CREATE INDEX idx_customer_email_local ON customer(location, email) INTERLEAVE IN locations;

L'exemple suivant crée un index unique global et un index distant :

GoogleSQL

CREATE UNIQUE INDEX idx_customer_email ON customer(email);
CREATE INDEX idx_customer_email_remote ON customer(location, email), INTERLEAVE IN root_placement_table;

PostgreSQL

CREATE UNIQUE INDEX idx_customer_email ON customer(email);
CREATE INDEX idx_customer_email_remote ON customer(location, email) INTERLEAVE IN root_placement_table;

Sur la base des exemples d'index précédents, l'exemple de requête suivant présente une latence intrarégionale :

GoogleSQL

SELECT *
FROM customer
WHERE email = @email;

PostgreSQL

SELECT *
FROM customer
WHERE email = @email;

Index unique global sur les clés primaires partielles

Spanner peut appliquer une optimisation semblable à celle décrite dans la section Index unique global avec un index local ou distant lors de l'utilisation d'un index unique global sur des clés primaires partielles.

L'exemple suivant crée une table customer entrelacée dans la table parente locations, puis crée un index unique global sur la colonne customerId.

GoogleSQL

-- Create locations placement table
CREATE TABLE locations (
location STRING(MAX) NOT NULL PLACEMENT KEY,
) PRIMARY KEY(location);

-- Create customer table interleaved in the locations table
CREATE TABLE customer (
  location STRING(MAX) NOT NULL,
  customerId  INT64 NOT NULL,
  email STRING(MAX),
  webcookie STRING(64),
) PRIMARY KEY(location, customerId), INTERLEAVE IN PARENT locations;

-- Create global unique index on customerId column
CREATE UNIQUE INDEX idx_customer_customerid ON customer(customerId);

PostgreSQL

-- Create locations placement table
CREATE TABLE locations (
  location varchar NOT NULL PLACEMENT KEY PRIMARY KEY
);

-- Create customer table interleaved in the locations table
CREATE TABLE customer (
  location varchar NOT NULL,
  customerId  BIGINT NOT NULL,
  email varchar(1024),
  webcookie varchar(64),
  PRIMARY KEY(location, customerId)
) INTERLEAVE IN PARENT locations;

-- Create global unique index on customerId column
CREATE UNIQUE INDEX idx_customer_customerid ON customer(customerId);

L'optimisation s'applique aux requêtes de ce type :

GoogleSQL

SELECT * FROM customer WHERE customerId = @customerId;

PostgreSQL

SELECT * FROM customer WHERE customerId = @customerId;

Si vous ne créez pas l'index unique global, cette requête peut nécessiter une analyse complète de la table. Si vous n'utilisez pas l'index unique global, vous devez ajouter le filtre d'emplacement dans votre requête pour obtenir une bonne latence de requête :

GoogleSQL

SELECT * FROM customer WHERE location = @location AND customerId = @customerId;

PostgreSQL

SELECT * FROM customer WHERE location = @location AND customerId = @customerId;

Consignes générales pour choisir un type d'index pour une latence optimale

Le type d'index que vous choisissez a un impact direct sur la latence des requêtes. L'emplacement des données d'index par rapport aux données de table est un facteur principal de performances pour les charges de travail de partitionnement géographique.

Cette section explique comment choisir entre des index globaux, locaux et distants.

Quand choisir des index globaux

Utilisez des index globaux si votre charge de travail peut tolérer la latence de lecture et d'écriture associée, ou si vous avez besoin d'appliquer l'unicité globale sur les colonnes indexées.

Tenez compte des points suivants lorsque vous choisissez des index globaux :

  • La distance entre le client et le leader du quorum d'écriture par défaut, ainsi que la latence par défaut du quorum, déterminent l'augmentation de la latence d'écriture. Cet effet est spécifiquement limité aux opérations impliquant des colonnes indexées, telles que l'insertion de lignes ou la mise à jour de colonnes indexées.
  • L'ajout d'instances répliquées en lecture seule ou l'utilisation de baux de lecture peut réduire l'augmentation de la latence de lecture :
    • L'ajout d'une instance répliquée en lecture seule à proximité géographique peut réduire la latence des lectures non actualisées.
    • L'ajout d'une instance répliquée en lecture seule et l'utilisation de régions de baux de lecture peuvent réduire la latence de lecture forte. Si vous ajoutez une instance répliquée en lecture seule sans utiliser de région de bail de lecture, la latence de lecture forte n'est pas réduite, mais le débit de lecture peut augmenter.
    • Spanner diffuse toujours les lectures transactionnelles pessimistes à partir du leader. L'ajout d'instances répliquées à l'emplacement par défaut n'est pas utile pour les lectures transactionnelles pessimistes des données dans les emplacements par défaut.
  • Les index globaux (y compris les clés et les valeurs de stockage) sont placés dans l'emplacement par défaut, qui ne fournit pas de résidence des données au niveau de l'emplacement. Pour en savoir plus, consultez la présentation de la résidence des données dans Spanner.

Quand choisir des index locaux et distants ?

Tenez compte des points suivants lorsque vous choisissez des index locaux et distants :

  • Les index locaux et distants offrent des performances de lecture et d'écriture locales, mais sacrifient l'unicité globale et les propriétés d'ordre des colonnes d'index uniques. Au lieu de cela, les index locaux et distants fournissent l'ordre et l'unicité des colonnes indexées dans la ligne parente dans laquelle ils sont entrelacés.
  • Lorsque vous utilisez des index locaux ou distants, vous devez inclure l'emplacement de l'emplacement dans le prédicat de requête, sauf s'il existe également un index unique global qui permet à Spanner de deviner l'emplacement de l'emplacement local. Sinon, le plan de requête et les performances ne sont pas déterministes. Spanner peut effectuer une analyse de la table de base ou une dispersion et une collecte à partir de l'index sur les emplacements de placement en fonction des statistiques de requête, ce qui augmente la latence.

Quand choisir des index uniques globaux avec des index locaux ou distants ?

Tenez compte des points suivants lorsque vous choisissez une combinaison d'index uniques globaux avec des index locaux ou distants :

  • Lorsque l'emplacement de l'emplacement spécifique est inconnu, utilisez une combinaison d'index uniques globaux avec des index locaux ou distants. Cette approche est idéale lorsque la plupart des requêtes proviennent de services situés géographiquement dans la même région que l'emplacement des données demandées.
  • Lors de l'écriture d'index globaux, la latence en écriture est soumise à une latence de quorum d'écriture par défaut supplémentaire.
  • Avec l'optimisation basée sur l'heuristique, les requêtes sont diffusées par des segments d'index locaux et présentent une latence intra-régionale la plupart du temps.

Consignes détaillées pour choisir un index pour des conceptions de schéma spécifiques

La stratégie d'indexation optimale dépend de la structure de la clé primaire de votre table et des schémas de requête de votre application. Cette section fournit des conseils pour sélectionner le type d'index approprié pour trois conceptions de schéma courantes :

  • Schémas qui utilisent une entité comme clé primaire
  • Schémas utilisant l'emplacement comme clé primaire
  • Schémas utilisant des valeurs liées à l'emplacement comme clé primaire

Conception de schéma : entité comme clé primaire

Si votre schéma utilise une entité comme clé primaire, choisissez votre stratégie d'indexation selon que l'emplacement est spécifié ou non dans vos requêtes.

Si une entité telle que customerID est la clé primaire et qu'une colonne distincte sans clé telle que location est la clé d'emplacement, déterminez votre stratégie d'indexation pour la table d'emplacement en fonction de vos schémas de requête. (N'utilisez pas d'entité comme clé primaire de la table d'emplacement si la latence d'insertion est un problème pour les entités.)

Si vous souhaitez indexer des données sous une entité particulière, telle que customerID, utilisez un index local. Les données sont indexées et triées au sein de l'entité, mais pas entre les entités. Par exemple, si vous souhaitez indexer les commandes de chaque client par date, vous pouvez créer un index local entrelacé sous l'identité customerID.

Lorsque l'emplacement est toujours connu dans vos requêtes, utilisez l'une des stratégies suivantes :

  • Si l'emplacement est systématiquement connu dans vos requêtes et qu'il n'est pas nécessaire d'appliquer l'unicité globale, utilisez des index distants. Ces index fournissent une latence intrarégionale pour les opérations de lecture et d'écriture.

    Les index distants ne sont compatibles qu'avec l'indexation des colonnes de la table d'emplacement, et non des colonnes des tables entrelacées. L'index distant doit être entrelacé sous la table d'emplacement racine. L'index distant indexe les données de toutes les lignes de l'emplacement.

Si l'emplacement n'est pas toujours connu dans vos requêtes, utilisez l'une des stratégies suivantes :

  • Si la colonne indexée est unique au niveau mondial, créez un index unique global pour appliquer cette unicité.

    Pour obtenir des lectures fortes à faible latence, créez un index distant en plus d'un index unique global.

    Avec cette combinaison, les écritures peuvent entraîner une latence interrégionale, tandis que les requêtes avec un emplacement spécifié (avec WHERE location = @location) bénéficient d'une latence intrarégionale en utilisant l'index distant. Pour les requêtes sans emplacement spécifié, Spanner utilise une optimisation basée sur l'heuristique en effectuant d'abord une recherche locale. Si les données ne sont pas trouvées, il utilise l'index global.

    Si vous utilisez des régions de location en lecture et que vous disposez d'une instance répliquée en lecture seule de la partition par défaut dans la même région que vos données, un index distant n'est pas nécessaire, car les régions de location en lecture fournissent déjà une faible latence de lecture forte pour les lectures d'un index global.

  • Si votre requête ne spécifie pas d'emplacement et que les colonnes indexées ne sont pas uniques au niveau mondial, ne créez qu'un index global (non unique). Dans ce cas, l'ajout d'un index local ou distant n'améliore pas la latence de lecture, car Spanner ne peut pas déterminer s'il existe des données correspondantes dans un autre emplacement, même s'il trouve des données dans l'emplacement local.

Conception de schéma : emplacement comme clé primaire

Lorsqu'une colonne location sert à la fois de clé primaire et de clé d'emplacement, votre sélection d'index est influencée par les problèmes de latence croisée et par le fait que vos requêtes spécifient ou non toujours l'emplacement.

  • Si la latence interrégionale n'est pas un problème ou si vous avez besoin d'une unicité globale, utilisez des index globaux.
  • Si la latence interrégionale vous préoccupe, que vos requêtes incluent toujours l'emplacement et que vous n'avez pas besoin que Spanner applique l'unicité globale, n'utilisez que des index locaux. Cela garantit une latence locale pour les lectures et les écritures.
  • Si la latence des requêtes interrégionales est un problème, que la latence d'écriture interrégionale est acceptable et que l'emplacement n'est pas toujours connu, les stratégies suivantes s'appliquent :

    Condition Recommandation
    Interroger par clé primaire partielle unique au niveau mondial

    Créez un index global unique pour appliquer l'unicité. Un index local n'est pas nécessaire, car la clé primaire remplit une fonction similaire. L'optimisation basée sur l'heuristique s'applique. Tout d'abord, Spanner vérifie la clé primaire complète avec l'emplacement local avant de revenir à l'index global.

    Pour obtenir un exemple, consultez Index unique global sur des clés primaires partielles.

    Interroger par colonne non-clé unique au niveau mondial

    Créez un index global unique pour appliquer l'unicité.

    Pour la latence intrarégionale, les scénarios suivants sont possibles :

    • Créez un index local sur la même colonne que l'index global. L'optimisation basée sur l'heuristique s'applique. La combinaison d'index globaux et locaux offre une faible latence pour les requêtes fortes et obsolètes intra-région, tandis que les écritures et les requêtes interrégionales ont une latence interrégionale.
    • S'il existe une instance répliquée en lecture/écriture ou en lecture seule de la partition par défaut dans la même région que vos données, alors :
      • Si vous n'avez besoin de la latence intrarégionale que pour les lectures non actualisées, mais pas pour les lectures fortes, vous n'avez pas besoin d'un index local. L'instance répliquée locale fournit une latence intrarégionale.
      • Si vous avez besoin d'une latence intra-régionale pour les lectures fortes, vous pouvez créer un index local sur la même colonne que l'index global ou utiliser des régions de baux de lecture. Les régions de bail de lecture offrent une faible latence de lecture forte au détriment de la latence d'écriture.
    La colonne indexée n'est pas unique au niveau mondial Créer uniquement un index global. Un index local n'améliore pas la latence de lecture, car Spanner peut avoir besoin de vérifier tous les emplacements.

Si ces trois scénarios ne s'appliquent pas à votre cas d'utilisation, vous devrez probablement sacrifier la simplicité de l'application ou la latence d'écriture en fournissant systématiquement l'emplacement.

Si la clé primaire de votre table est basée sur des valeurs liées à l'emplacement, mais qu'il ne s'agit pas directement de la colonne de clé d'emplacement (par exemple, en utilisant country comme clé primaire lorsque vous avez moins d'emplacements que de pays), vous pouvez utiliser un index global ou un index local (entrelacé sous la colonne country). Toutefois, les index distants ne sont pas compatibles avec les tables entrelacées sous ce type de table d'emplacement.

L'optimisation basée sur l'heuristique n'est pas compatible avec les index locaux dans ce scénario. Par conséquent, vous n'obtenez une latence locale que lorsque votre requête spécifie explicitement le préfixe de clé primaire.