インデックスと地域別パーティショニング

Spanner には、クエリのパフォーマンスを向上させるためのインデックスがいくつか用意されています。スキーマとクエリパターンに適切なインデックス タイプを選択することは、特に地域別パーティショニングを使用するデータベースにとって重要です。このページでは、さまざまなインデックス タイプの利点と、地域別パーティショニングで Spanner インデックスを選択して使用するためのベスト プラクティスについて説明します。

インデックスのタイプ

Spanner は、グローバル インデックス、ローカル インデックス、リモート インデックスをサポートしています。種類ごとにパフォーマンス特性とユースケースが異なります。地域別パーティショニング データベースの場合、これらのインデックス タイプを理解することが重要です。適切なインデックスを選択すると、データベース スキーマとクエリを最適化できます。これにより、地域別パーティショニング データベースのレイテンシを大幅に改善できます。地域別パーティショニングを使用しないデータベースの場合、これらのインデックス タイプはすべてデフォルトのプレースメントに保存され、同様のパフォーマンス特性を持つため、これらのインデックス タイプを理解することはそれほど重要ではありません。

グローバル インデックス

グローバル インデックスは、Spanner のデフォルトのインデックス タイプです。インデックス データはデフォルトのパーティションに保存されます。このパーティションは、テーブルのデータと同じ場所に配置されない場合があります。地域別パーティション分割テーブルにグローバル インデックスを作成すると、インデックス付き列を含む書き込みの書き込みレイテンシが大幅に増加する可能性があります。特に、インデックスのデフォルトのパーティション書き込みクォーラムが、書き込み対象のテーブル行の書き込みクォーラムから遠い場合は、その可能性が高くなります。グローバル インデックスの読み取りレイテンシを軽減するには、読み取りリース リージョンまたはステイル読み取りとともに、近くの読み取り専用レプリカを使用します。

グローバル インデックスには次の特性があります。

  • これにより、テーブル全体のスキャンが必要なクエリが高速化され、ロケーションに関係なくすべてのテーブル行で一意性が適用されます。
  • データベース全体で一意の値が必要な列に適しています。
  • インデックス付きの列でフィルタリングまたは並べ替えを行うクエリを高速化します。

グローバル一意インデックスの例を次に示します。

CREATE UNIQUE INDEX idx_customer_email ON customer(email);

ローカル インデックス

ローカル インデックスは、インデックス付きテーブルの親階層にインターリーブされます。主キーの列名と型は、インデックス付きテーブルと一致する必要があります。

ローカル インデックスには次の特徴があります。

  • インデックス データは、インデックスが作成されるデータと同じパーティションに保存されます。書き込みレイテンシは、デフォルトのプレースメントの書き込みクォーラムではなく、特定のプレースメントの書き込みクォーラムの影響を受けます。

  • インデックスとテーブルデータの両方が同じプレースメントに配置されるため、特定のキー プレフィックスをターゲットとするクエリのレイテンシが最も低くなります。

ローカル インデックスを作成するには、親テーブルにインデックスをインターリーブします。UNIQUE ローカル インデックスを使用する場合、一意性は特定の親行内でのみ適用され、テーブル全体には適用されません。

次の例では、親テーブル locations にインターリーブされたテーブル customer にローカル インデックスを作成します。

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;

読み取り / 書き込みトランザクションでデータをクエリする場合は、クエリでインデックス付きテーブルの主キーの接頭辞を指定する必要があります。そうしないと、クエリでテーブル全体のスキャンが必要になる場合があります。次に例を示します。

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;

ロケーションを指定する必要のない最適化については、ローカル インデックスまたはリモート インデックスを使用したグローバル一意インデックスをご覧ください。

ローカル インデックスは、プレースメント テーブルがエンティティ ベースで、特定のエンティティまたはサブエンティティ内のデータをインデックスに登録する場合にも役立ちます。次に例を示します。

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;

リモート インデックス

リモート インデックスは、インデックス付きテーブルのインターリーブ階層の祖先ではないテーブルの下にインデックス データをインターリーブします。主キーの型は、対応するインデックス列の型と一致する必要がありますが、名前は異なっていてもかまいません。

地域別パーティショニングを使用すると、自動的に管理されるルート プレースメント テーブルの下にのみリモート インデックスをインターリーブできます。ルート プレースメント テーブルのデータベース オプション(auto_managed_root_placement_table_name)を有効にすると、Spanner は内部テーブルを作成し、データベース内のプレースメントごとに 1 行を入力します。このテーブルをプレースメント テーブル インデックスのインターリーブ ルートとして使用すると、インデックス エントリは対応する行と同じプレースメントを使用します。これにより、Spanner は、遠くのリージョンからインデックス エントリを取得するのではなく、パーティションに対してローカルなインデックス ルックアップを実行できます。

リモート インデックスには次の特徴があります。

  • インデックス データは、ローカル インデックスと同じインスタンス パーティションに保存されます。
  • これらは、テーブルの主キーにプレースメント キーが接頭辞として付加されていない場合(エンティティ ID が主キーである場合など)に特に役立ちます。また、プレースメント キーに従ってインデックスのパーティションを地理的に同じ場所に配置する場合にも役立ちます。
  • これらは、プレースメント テーブルの列のインデックス作成のみをサポートし、インターリーブされた子テーブルの列はサポートしません。

地域別パーティショニングでリモート インデックスを使用するには、ルート プレースメント テーブルのデータベース オプションを有効にして、そのテーブルにインターリーブされたリモート インデックスを作成します。

  1. ALTER DATABASE DDL ステートメントを使用して auto_managed_root_placement_table_name オプションを設定し、ルート プレースメント テーブルを作成します。このオプションは、データベースの作成後に ALTER DATABASE ステートメントで設定する必要があります。このオプションを設定すると、ルート プレースメント テーブルの名前変更や無効化はできなくなります。

    GoogleSQL

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

    次のように置き換えます。

    • DATABASE_NAME: データベースの名前。
    • TABLE_NAME: 作成するテーブルの名前。root_placement_table という名前を使用することをおすすめします。

    たとえば、次のステートメントは root_placement_table というテーブルを作成します。

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

    ルート プレースメント テーブルを作成すると、Spanner は次の定義を持つ内部テーブルを作成し、プレースメントの作成または削除時に行を自動的に挿入または削除します。このテーブルを自分で作成する必要はありません。

    -- 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';
    

    次のように置き換えます。

    • DATABASE_NAME: データベースの名前。
    • TABLE_NAME: 作成するテーブルの名前。root_placement_table という名前を使用することをおすすめします。

    たとえば、次のステートメントは root_placement_table というテーブルを作成します。

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

    ルート プレースメント テーブルを作成すると、Spanner は次の定義を持つ内部テーブルを作成し、プレースメントの作成または削除時に行を自動的に挿入または削除します。このテーブルを自分で作成する必要はありません。

    -- 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. 自動的に管理される root_placement_table テーブルの下にインターリーブされたリモート インデックスを作成します。プレースメント キー列とインデックスに登録する列にインデックスを定義する場合は、プレースメント キー列を最初に指定する必要があります。

    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. 読み取り / 書き込みトランザクションでデータをクエリする場合、またはクエリ時に配置場所がわかっている場合は、クエリ述語にインデックスのキー接頭辞(配置キー列)を指定して、テーブルのフルスキャンが不要になるようにします。クライアントが、指定されたプレースメントのレプリカの 1 つと同じリージョンにある場合、クエリはパーティション ローカル データアクセスで実行されます。次に例を示します。

    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;
    

    クエリ時にプレースメントのロケーションが不明で、インデックスに登録された列がプレースメント間で一意である場合は、グローバル一意インデックスとリモート インデックスを組み合わせることで、WHERE 句でロケーションを指定する必要がなくなります。詳細については、ローカル インデックスまたはリモート インデックスを使用したグローバル一意インデックスをご覧ください。

グローバル一意インデックスの最適化

グローバル一意インデックスを使用すると、Spanner は次のユースケースで、ヒューリスティック ベースの最適化によりクエリ レイテンシの改善をトリガーする場合があります。

  • ローカル インデックスまたはリモート インデックスでグローバル一意インデックスを使用する場合
  • 部分主キーでグローバル一意インデックスを使用する場合

以降のセクションでは、Spanner が各ユースケースで最適化を適用する方法について説明します。

ローカル インデックスまたはリモート インデックスを使用したグローバル一意インデックス

ローカルクエリのレイテンシを改善するため、グローバル一意インデックスがローカル インデックスまたはリモート インデックスと組み合わされている場合、Spanner はヒューリスティック ベースの最適化を開始することがあります。

この最適化により、リージョン内クエリのレイテンシが最小限に抑えられます。これは、地域別パーティショニングされたデータの場所が指定されていない場合でも、配置がクライアントの場所と同じであると推測し、グローバル インデックスのデフォルト パーティションをバイパスするか、フィルタされたフルテーブル スキャンの必要性を排除することで実現されます。このようなアプローチは、クライアントが主に独自のリージョンに保存されているデータにアクセスする場合に特に有益です。

リージョン内のクエリ レイテンシが主な懸念事項であり、書き込みレイテンシの増加とグローバル インデックスの追加ストレージ費用を許容できる場合は、異なるインデックス タイプを組み合わせて使用すると便利です。異なるインデックス タイプを組み合わせると、クエリでロケーションを指定しない場合でも、リージョン内クエリのパフォーマンスが向上します。

この最適化では、同じ列にグローバル一意インデックスと、対応するローカル インデックスまたはリモート インデックスを作成する必要があります。インデックス付きデータはグローバルに一意である必要があります。これにより、列の一意の値ごとにインデックス エントリが 1 つだけ存在することがクエリ オプティマイザーに通知されます。次の条件に該当する場合、Spanner はこの最適化をクエリに適用します。

  • 主キーのプレフィックスが不明で、データの場所を指定しない。
  • リクエストが、ローカルまたはリモートのインデックス シャードを含むデータ配置のデフォルト リーダーと同じリージョンから発信されている。

Spanner は、次の方法で最適化を適用します。

  • 最適化がトリガーされ、行がローカル プレースメントで見つかった場合: グローバル一意インデックスが指定されている場合、クエリ オプティマイザーはまずインデックスのローカル シャードを使用してクエリを評価し、他のロケーションを検索する必要はありません。クエリにリージョン内のレイテンシがある。
  • 最初のロケーション検索で行が返されない場合: これは、リージョン内クエリではないことを示します。クエリ オプティマイザーは、グローバル インデックスを参照するようにフォールバックします。

次の例では、グローバル一意インデックスとローカル インデックスを作成します。

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;

次の例では、グローバル一意インデックスとリモート インデックスを作成します。

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;

前述のインデックスの例に基づくと、次のクエリの例ではリージョン内のレイテンシが発生します。

GoogleSQL

SELECT *
FROM customer
WHERE email = @email;

PostgreSQL

SELECT *
FROM customer
WHERE email = @email;

部分主キーのグローバル一意インデックス

Spanner は、部分主キーにグローバル一意インデックスを使用する場合、ローカル インデックスまたはリモート インデックスを使用したグローバル一意インデックスで説明されている最適化と同様の最適化を適用できます。

次の例では、親テーブル locations にインターリーブされた customer を作成し、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);

この最適化は、次のようなクエリに適用されます。

GoogleSQL

SELECT * FROM customer WHERE customerId = @customerId;

PostgreSQL

SELECT * FROM customer WHERE customerId = @customerId;

グローバル一意インデックスを作成しない場合、このクエリではテーブルのフルスキャンが必要になることがあります。グローバル一意インデックスを使用していない場合は、クエリにロケーション フィルタを追加して、クエリのレイテンシを短縮する必要があります。

GoogleSQL

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

PostgreSQL

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

最適なレイテンシを実現するインデックス タイプを選択するための一般的なガイドライン

選択するインデックスのタイプは、クエリのレイテンシに直接影響します。テーブルデータに対するインデックス データの位置は、地域別パーティショニングされたワークロードのパフォーマンスに大きく影響します。

このセクションでは、グローバル インデックス、ローカル インデックス、リモート インデックスの選択方法について説明します。

グローバル インデックスを選択するタイミング

ワークロードが関連する読み取りと書き込みのレイテンシを許容できる場合、またはインデックス付き列にグローバルな一意性を適用する必要がある場合は、グローバル インデックスを使用します。

グローバル インデックスを選択する際は、次の点を考慮してください。

  • 書き込みレイテンシの増加は、クライアントとデフォルトの書き込みクォーラムのリーダー間の距離と、クォーラムのデフォルトのレイテンシによって決まります。この影響は、インデックス付きの列を含むオペレーション(行の挿入やインデックス付きの列の更新など)に限定されます。
  • 読み取り専用レプリカを追加するか、読み取りリースを使用すると、読み取りレイテンシの増加を軽減できます。
    • 地理的に近い場所に読み取り専用レプリカを追加すると、ステイル読み取りのレイテンシを短縮できます。
    • 読み取り専用レプリカを追加して読み取りリース リージョンを使用すると、強力な読み取りのレイテンシを短縮できます。読み取りリース リージョンを使用せずに読み取り専用レプリカを追加すると、強力な読み取りレイテンシは短縮されませんが、読み取りスループットは増加する可能性があります。
    • Spanner は、常にリーダーから悲観的なトランザクション読み取りを提供します。デフォルトのプレースメントにレプリカを追加しても、デフォルトのプレースメントのデータの悲観的なトランザクション読み取りには役立ちません。
  • グローバル インデックス(キーと保存値を含む)は、デフォルトのプレースメントに配置されます。デフォルトのプレースメントでは、プレースメント レベルのデータ所在地は提供されません。詳細については、Spanner のデータ所在地の概要をご覧ください。

ローカル インデックスとリモート インデックスを選択するタイミング

ローカル インデックスとリモート インデックスを選択する際は、次の点を考慮してください。

  • ローカル インデックスとリモート インデックスは、プレースメント ローカルの読み取りと書き込みのパフォーマンスを提供しますが、一意のインデックス列のグローバルな一意性と順序付けプロパティを犠牲にします。代わりに、ローカル インデックスとリモート インデックスは、インターリーブされている親行内のインデックス付き列の順序と一意性を提供します。
  • ローカル インデックスまたはリモート インデックスを使用する場合は、クエリ述語にプレースメント ロケーションを含める必要があります。ただし、Spanner がローカル プレースメント ロケーションを推測できるグローバル一意インデックスがある場合は除きます。そうしないと、クエリプランとパフォーマンスが確定的になりません。Spanner は、クエリの統計情報に基づいて、ベーステーブル スキャンを実行するか、プレースメント ロケーション間でインデックスからスキャッターとギャザーを実行し、レイテンシを増加させる可能性があります。

ローカル インデックスまたはリモート インデックスでグローバル一意インデックスを選択するタイミング

グローバル一意インデックスとローカル インデックスまたはリモート インデックスの組み合わせを選択する場合は、次の点を考慮してください。

  • 特定のプレースメント ロケーションが不明な場合は、グローバル一意インデックスとローカル インデックスまたはリモート インデックスを組み合わせて使用します。このアプローチは、ほとんどのクエリが、リクエストされたデータの配置と同じリージョンに地理的に配置されたサービスから送信される場合に最適です。
  • グローバル インデックスを書き込む場合、書き込みレイテンシはデフォルトの書き込みクォーラム レイテンシの影響を受けます。
  • ヒューリスティック ベースの最適化により、クエリはローカル インデックス シャードによって処理され、ほとんどの場合、リージョン内のレイテンシが示されます。

特定のスキーマ設計のインデックスを選択するための詳細なガイドライン

最適なインデックス戦略は、テーブルの主キー構造とアプリケーションのクエリパターンによって異なります。このセクションでは、3 つの一般的なスキーマ設計に適したインデックス タイプを選択するためのガイダンスを提供します。

  • エンティティを主キーとして使用するスキーマ
  • ロケーションを主キーとして使用するスキーマ
  • ロケーション関連の値を主キーとして使用するスキーマ

スキーマ設計: エンティティを主キーにする

スキーマでエンティティを主キーとして使用する場合は、クエリでロケーションが指定されているかどうかに基づいてインデックス戦略を選択します。

customerID などのエンティティが主キーで、location などの別の非キー列がプレースメント キーである場合は、クエリパターンに基づいてプレースメント テーブルのインデックス戦略を決定します。(エンティティの挿入レイテンシが懸念される場合は、エンティティをプレースメント テーブルの主キーとして使用しないでください)。

customerID などの特定のエンティティの下でデータをインデックスに登録する場合は、ローカル インデックスを使用します。データはエンティティ内でインデックスに登録され、並べ替えられますが、エンティティ間では行われません。たとえば、各顧客の注文を日付でインデックスに登録する場合は、customerID ID の下にインターリーブされたローカル インデックスを作成します。

クエリで位置情報が常にわかっている場合は、次のいずれかの方法を使用します。

  • クエリでロケーションが常に認識され、グローバルな一意性を適用する必要がない場合は、リモート インデックスを使用します。これらのインデックスは、読み取りオペレーションと書き込みオペレーションの両方でリージョン内レイテンシを実現します。

    リモート インデックスは、プレースメント テーブルのインデックス列のみをサポートし、インターリーブされたテーブルの列はサポートしません。リモート インデックスは、ルート プレースメント テーブルの下にインターリーブする必要があります。リモート インデックスは、プレースメントのすべてのプレースメント行にわたってデータをインデックスに登録します。

クエリでロケーションが常にわかっているわけではない場合は、次のいずれかの戦略を使用します。

  • インデックス付きの列がグローバルに一意である場合は、グローバル一意インデックスを作成して、その一意性を適用します。

    低レイテンシの強力な読み取りを実現するには、グローバル一意インデックスに加えてリモート インデックスを作成します。

    この組み合わせでは、書き込みでクロスリージョン レイテンシが発生する可能性がありますが、場所を指定したクエリ(WHERE location = @location を使用)では、リモート インデックスを使用することでリージョン内レイテンシのメリットが得られます。ロケーションが指定されていないクエリの場合、Spanner は最初にローカルで検索することで、ヒューリスティック ベースの最適化を使用します。データが見つからない場合は、グローバル インデックスにフォールバックします。

    読み取りリース リージョンを使用しており、データと同じリージョンにデフォルト パーティションの読み取り専用レプリカがある場合、読み取りリース リージョンはグローバル インデックスの読み取りに対して強力な読み取りレイテンシをすでに提供しているため、リモート インデックスは不要です。

  • クエリでロケーションが指定されておらず、インデックスに登録された列がグローバルに一意でない場合は、グローバル(一意でない)インデックスのみを作成します。この場合、ローカル インデックスまたはリモート インデックスを追加しても、読み取りレイテンシは改善されません。Spanner は、ローカル プレースメントでデータが見つかった場合でも、別のプレースメントに一致するデータがあるかどうかを判断できないためです。

スキーマ設計: 主キーとしての場所

location 列が主キーとプレースメント キーの両方として機能する場合、インデックスの選択は、クロスレイテンシの問題と、クエリで常にロケーションが指定されるかどうかによって決まります。

  • クロスリージョン レイテンシが問題にならない場合や、グローバルな一意性が必要な場合は、グローバル インデックスを使用します。
  • クロスリージョン レイテンシが懸念される場合、クエリに常にロケーションが含まれ、Spanner でグローバルな一意性を適用する必要がない場合は、ローカル インデックスのみを使用します。これにより、読み取りと書き込みの両方でローカル レイテンシが確保されます。
  • クロスリージョン クエリのレイテンシが懸念される場合、クロスリージョン書き込みのレイテンシが許容され、ロケーションが常にわかっているわけではない場合は、次の戦略が適用されます。

    条件 推奨事項
    グローバルに一意な部分主キーでクエリを実行する

    一意性を適用するために、一意のグローバル インデックスを作成します。主キーが同様の機能を実行するため、ローカル インデックスは必要ありません。ヒューリスティック ベースの最適化が適用されます。まず、Spanner はローカル ロケーションで完全な主キーを確認してから、グローバル インデックスにフォールバックします。

    例については、部分主キーのグローバル一意インデックスをご覧ください。

    非キーのグローバルに一意の列でクエリを実行する

    一意性を適用するために、一意のグローバル インデックスを作成します。

    リージョン内のレイテンシについては、次のシナリオが考えられます。

    • グローバル インデックスと同じ列にローカル インデックスを作成します。ヒューリスティック ベースの最適化が適用されます。グローバル インデックスとローカル インデックスを組み合わせることで、リージョン内の強力なクエリと古いクエリのレイテンシが低くなります。一方、書き込み、クロスリージョン クエリ、書き込みにはクロスリージョン レイテンシが発生します。
    • データと同じリージョンにデフォルト パーティションの読み取り / 書き込みレプリカまたは読み取り専用レプリカがある場合:
      • ステイル読み取りにのみリージョン内レイテンシが必要で、強力な読み取りには必要ない場合は、ローカル インデックスは必要ありません。ローカル レプリカはリージョン内のレイテンシを提供します。
      • 強力な読み取りにリージョン内のレイテンシが必要な場合は、グローバル インデックスと同じ列にローカル インデックスを作成するか、読み取りリース リージョンを使用します。読み取りリース リージョンでは、書き込みレイテンシを犠牲にして、強力な読み取りレイテンシを低減します。
    インデックス化された列がグローバルに一意でない グローバル インデックスのみを作成します。Spanner はすべてのロケーションを確認する必要があるため、ローカル インデックスを使用しても読み取りレイテンシは改善されません。

これらの 3 つのシナリオがユースケースに該当しない場合は、一貫して位置情報を提供することで、アプリケーションのシンプルさや書き込みレイテンシを犠牲にする必要があります。

テーブルの主キーがロケーション関連の値に基づいているが、プレースメント キー列ではない場合(たとえば、プレースメントが国よりも少ない場合に country を主キーとして使用する場合)、グローバル インデックスまたはローカル インデックス(country 列の下にインターリーブ)を使用できます。ただし、このタイプのプレースメント テーブルにインターリーブされたテーブルでは、リモート インデックスはサポートされていません。

このシナリオでは、ヒューリスティック ベースの最適化はローカル インデックスでサポートされていません。したがって、クエリで主キーの接頭辞を明示的に指定した場合にのみ、ローカル レイテンシが実現されます。