Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.10. SQL キャッシュストア

SQL キャッシュストアを使用すると、既存のデータベーステーブルから Data Grid キャッシュを読み込むことができます。Data Grid は、2 種類の SQL キャッシュストアを提供します。

テーブル
Data Grid は、1 つのデータベーステーブルからエントリーを読み込みます。
クエリー
Data Grid は SQL クエリーを使用して、単一または複数のデータベーステーブルからエントリーを読み込み (これらのテーブルのサブ列からの読み込みを含む)、挿入、更新、および削除操作を実行します。
ヒント

コードチュートリアルにアクセスして、SQL キャッシュストアの動作を試します。Persistence code tutorial with remote caches を参照してください。

SQL テーブルとクエリーストアの両方は以下のようになります。

  • 永続ストレージに対する読み取りおよび書き込み操作を許可します。
  • 読み取り専用で、キャッシュローダーとして機能します。

  • 単一のデータベース列または複数のデータベース列の複合に対応するキーと値をサポートします。

    複合キーと値の場合は、キーと値を記述する Protobuf スキーマ (.proto ファイル) で Data Grid を指定する必要があります。Data Grid Server を使用すると、schema コマンドを使用して、Data Grid Console または Command Line Interface(CLI) から schema を追加できます。

警告

SQL キャッシュストアは、既存のデータベーステーブルで使用することを目的としています。したがって、有効期限、セグメント、バージョン管理メタデータなどのメタデータは保存されません。バージョンストレージがないため、SQL ストアは楽観的トランザクションキャッシュと非同期クロスサイトレプリケーションをサポートしません。この制限は、Hot Rod のバージョン管理された操作にも適用されます。

ヒント

SQL キャッシュストアが読み取り専用として設定されている場合は、SQL キャッシュストアとともに有効期限を使用します。有効期限により、古い値がメモリーから削除され、キャッシュがデータベースから値を再度取得し、新たにキャッシュします。

6.10.1. キーおよび値のデータ型
リンクのコピー

Data Grid は、適切なデータ型を使用して、SQL キャッシュストアを介してデータベーステーブルの列からキーと値を読み込みます。以下の CREATE ステートメントは、isbn と title の 2 つの列が含まれる books という名前のテーブルを追加します。

2 列のデータベーステーブル

CREATE TABLE books (
    isbn NUMBER(13),
    title varchar(120)
    PRIMARY KEY(isbn)
);
Copy to Clipboard Toggle word wrap

SQL キャッシュストアでこのテーブルを使用すると、Data Grid は isbn 列をキーとして、title 列を値として使用してキャッシュに追加します。

6.10.1.1. 複合キーと値
リンクのコピー

複合プライマリーキーまたは複合値を含むデータベーステーブルで SQL ストアを使用できます。

複合キーまたは値を使用するには、データ型を記述する Protobuf スキーマで Data Grid を指定する必要があります。また、SQL ストアに schema 設定を追加し、キーと値のメッセージ名を指定する必要があります。

ヒント

Data Grid は、ProtoStream プロセッサーで Protobuf スキーマを生成することを推奨します。次に、Data Grid コンソール、CLI、または REST API を使用してリモートキャッシュの Protobuf スキーマをアップロードできます。

複合値

以下のデータベーステーブルは、title および author 列の複合値を保持します。 

CREATE TABLE books (
    isbn NUMBER(13),
    title varchar(120),
    author varchar(80)
    PRIMARY KEY(isbn)
);
Copy to Clipboard Toggle word wrap

Data Grid は、isbn 列をキーとして使用してキャッシュにエントリーを追加します。値の場合、Data Grid には title 列と author 列をマッピングする Protobuf スキーマが必要です。 

package library;

message books_value {
    optional string title = 1;
    optional string author = 2;
}
Copy to Clipboard Toggle word wrap
複合キーと値

以下のデータベーステーブルは複合プライマリーキーと複合値を保持し、それぞれに 2 列があります。 

CREATE TABLE books (
    isbn NUMBER(13),
    reprint INT,
    title varchar(120),
    author varchar(80)
    PRIMARY KEY(isbn, reprint)
);
Copy to Clipboard Toggle word wrap

キーと値の両方で、Data Grid には列をキーと値にマッピングする Protobuf スキーマが必要です。 

package library;

message books_key {
    required string isbn = 1;
    required int32 reprint = 2;
}

message books_value {
    optional string title = 1;
    optional string author = 2;
}
Copy to Clipboard Toggle word wrap

6.10.1.2. 埋め込みキー
リンクのコピー

以下の例のように、Protobuf スキーマは値の中にキーを含めることができます。

組み込みキーを使用した Protobuf スキーマ

package library;

message books_key {
    required string isbn = 1;
    required int32 reprint = 2;
}

message books_value {
    required string isbn = 1;
    required string reprint = 2;
    optional string title = 3;
    optional string author = 4;
}
Copy to Clipboard Toggle word wrap

埋め込みキーを使用するには、SQL ストア設定に embedded-key="true" 属性または embeddedKey(true) メソッドを含める必要があります。

6.10.1.3. SQL から Protobuf タイプへ
リンクのコピー

以下の表に、SQL データ型のデフォルトを Protobuf データ型にマッピングしています。

Expand
SQL 型Protobuf タイプ

int4

int32

int8

int64

float4

float

float8

double

numeric

double

bool

bool

char

string

varchar

string

text、tinytext、mediumtext、longtext

string

bytea、tinyblob、Blob、mediumblob、longblob

bytes

6.10.2. データベーステーブルからの Data Grid キャッシュの読み込み
リンクのコピー

Data Grid にデータベーステーブルからデータを読み込ませる場合は、SQL テーブルキャッシュストアを設定に追加します。データベースに接続すると、Data Grid はテーブルからメタデータを使用して列名とデータタイプを検出します。また、Data Grid は、データベースのどの列がプライマリーキーの一部であるかを自動的に決定します。

前提条件

  • JDBC 接続の詳細を把握している。
    JDBC 接続ファクトリーを直接キャッシュ設定に追加できます。
    実稼働環境でのリモートキャッシュでは、マネージドデータソースを Data Grid Server 設定に追加し、キャッシュ設定で JNDI 名を指定する必要があります。

  • 複合キーまたは複合値の Protobuf スキーマを生成し、スキーマを Data Grid に登録します。

    ヒント

    Data Grid は、ProtoStream プロセッサーで Protobuf スキーマを生成することを推奨します。リモートキャッシュでは、Data Grid コンソール、CLI、または REST API を使用してスキーマを追加して、スキーマを登録できます。

手順

  1. データベースドライバーを Data Grid デプロイメントに追加します。

    • リモートキャッシュ: データベースドライバーを、Data Grid Server インストールの server/lib ディレクトリーにコピーします。

      ヒント

      Data Grid コマンドラインインターフェイス (CLI) で install コマンドを使用して、必要なドライバーを server/lib ディレクトリーにダウンロードします。以下に例を示します。 

      install org.postgresql:postgresql:42.4.3
      Copy to Clipboard Toggle word wrap

    • 組み込みキャッシュ: infinispan-cachestore-sql 依存関係を pom ファイルに追加します。 

      <dependency>
  <groupId>org.infinispan</groupId>
  <artifactId>infinispan-cachestore-sql</artifactId>
</dependency>
      Copy to Clipboard Toggle word wrap
  2. Data Grid 設定を開いて編集します。

  3. SQL テーブルキャッシュストアを追加します。

    宣言的

    table-jdbc-store xmlns="urn:infinispan:config:store:sql:14.0"
    Copy to Clipboard Toggle word wrap

    プログラマティック

    persistence().addStore(TableJdbcStoreConfigurationBuilder.class)
    Copy to Clipboard Toggle word wrap

  4. データベースダイアレクトを dialect="" または dialect() のいずれかで指定します (例:dialect="H2" または dialect="postgres")。

  5. 以下のように、必要なプロパティーで SQL キャッシュストアを設定します。

    • クラスター全体で同じキャッシュストアを使用するには、shared="true" または shared(true) を設定します。
    • 読み取り専用のキャッシュストアを作成するには、read-only="true" または .ignoreModifications(true) を設定します。
  6. table-name="<database_table_name>" または table.name("<database_table_name>") を使用して、キャッシュを読み込むデータベーステーブルに名前を付けます。

  7. schema 要素または .schemaJdbcConfigurationBuilder() メソッドを追加し、複合キーまたは値の Protobuf スキーマ設定を追加します。

    1. package 属性または package() メソッドを使用してパッケージ名を指定します。
    2. message-name 属性または messageName() メソッドを使用して複合値を指定します。
    3. key-message-name 属性または keyMessageName() メソッドを使用して複合キーを指定します。
    4. スキーマで値内にキーが含まれている場合は、embedded-key 属性または embeddedKey() メソッドに true の値を設定します。
  8. 変更を設定に保存します。
SQL テーブルストアの設定

以下の例では、Protobuf スキーマで定義された複合値を使用して、books という名前のデータベーステーブルから分散キャッシュを読み込みます。

XML

<distributed-cache>
  <persistence>
    <table-jdbc-store xmlns="urn:infinispan:config:store:sql:14.0"
                      dialect="H2"
                      shared="true"
                      table-name="books">
      <schema message-name="books_value"
              package="library"/>
    </table-jdbc-store>
  </persistence>
</distributed-cache>
Copy to Clipboard Toggle word wrap

JSON

{
  "distributed-cache": {
    "persistence": {
      "table-jdbc-store": {
        "dialect": "H2",
        "shared": "true",
        "table-name": "books",
        "schema": {
          "message-name": "books_value",
          "package": "library"
        }
      }
    }
  }
}
Copy to Clipboard Toggle word wrap

YAML

distributedCache:
  persistence:
    tableJdbcStore:
      dialect: "H2"
      shared: "true"
      tableName: "books"
      schema:
        messageName: "books_value"
        package: "library"
Copy to Clipboard Toggle word wrap

ConfigurationBuilder

ConfigurationBuilder builder = new ConfigurationBuilder();
builder.persistence().addStore(TableJdbcStoreConfigurationBuilder.class)
      .dialect(DatabaseType.H2)
      .shared("true")
      .tableName("books")
      .schemaJdbcConfigurationBuilder()
        .messageName("books_value")
        .packageName("library");
Copy to Clipboard Toggle word wrap

6.10.3. SQL クエリーを使用したデータのロードおよび操作の実行
リンクのコピー

SQL クエリーキャッシュストアを使用すると、データベーステーブルのサブ列からなど、複数のデータベーステーブルからキャッシュを読み込み、挿入、更新、および削除操作を実行することができます。

前提条件

  • JDBC 接続の詳細を把握している。
    JDBC 接続ファクトリーを直接キャッシュ設定に追加できます。
    実稼働環境でのリモートキャッシュでは、マネージドデータソースを Data Grid Server 設定に追加し、キャッシュ設定で JNDI 名を指定する必要があります。

  • 複合キーまたは複合値の Protobuf スキーマを生成し、スキーマを Data Grid に登録します。

    ヒント

    Data Grid は、ProtoStream プロセッサーで Protobuf スキーマを生成することを推奨します。リモートキャッシュでは、Data Grid コンソール、CLI、または REST API を使用してスキーマを追加して、スキーマを登録できます。

手順

  1. データベースドライバーを Data Grid デプロイメントに追加します。

    • リモートキャッシュ: データベースドライバーを、Data Grid Server インストールの server/lib ディレクトリーにコピーします。

      ヒント

      Data Grid コマンドラインインターフェイス (CLI) で install コマンドを使用して、必要なドライバーを server/lib ディレクトリーにダウンロードします。以下に例を示します。 

      install org.postgresql:postgresql:42.4.3
      Copy to Clipboard Toggle word wrap

    • 組み込みキャッシュ: infinispan-cachestore-sql 依存関係を pom ファイルに追加し、データベースドライバーがアプリケーションクラスパス上にあることを確認します。 

      <dependency>
  <groupId>org.infinispan</groupId>
  <artifactId>infinispan-cachestore-sql</artifactId>
</dependency>
      Copy to Clipboard Toggle word wrap
  2. Data Grid 設定を開いて編集します。

  3. SQL クエリーキャッシュストアを追加します。

    宣言的

    query-jdbc-store xmlns="urn:infinispan:config:store:sql:14.0"
    Copy to Clipboard Toggle word wrap

    プログラマティック

    persistence().addStore(QueriesJdbcStoreConfigurationBuilder.class)
    Copy to Clipboard Toggle word wrap

  4. データベースダイアレクトを dialect="" または dialect() のいずれかで指定します (例:dialect="H2" または dialect="postgres")。

  5. 以下のように、必要なプロパティーで SQL キャッシュストアを設定します。

    • クラスター全体で同じキャッシュストアを使用するには、shared="true" または shared(true) を設定します。
    • 読み取り専用のキャッシュストアを作成するには、read-only="true" または .ignoreModifications(true) を設定します。

  6. データでキャッシュを読み込み、queries 要素または queries() メソッドでデータベーステーブルを変更する SQL クエリーステートメントを定義します。

    Expand
    クエリーステートメント説明

    SELECT

    単一のエントリーをキャッシュに読み込みます。ワイルドカードを使用できますが、キーのパラメーターを指定する必要があります。ラベル付きの式を使用できます。

    SELECT ALL

    複数のエントリーをキャッシュに読み込みます。返された列の数がキーと値の列数と一致する場合は、* ワイルドカードを使用できます。ラベル付きの式を使用できます。

    SIZE

    キャッシュ内のエントリー数をカウントします。

    DELETE

    キャッシュからエントリーを 1 つ削除します。

    DELETE ALL

    キャッシュからすべてのエントリーを削除します。

    UPSERT

    キャッシュのエントリーを修正します。

    注記

    DELETE、DELETE ALL、および UPSERT ステートメントは読み取り専用キャッシュストアには適用されませんが、キャッシュストアが変更を許可する場合は必要です。

    DELETE ステートメントのパラメーターは、SELECT ステートメントのパラメーターに完全に一致する必要があります。

    UPSERT ステートメントの変数には、SELECT および SELECT ALL ステートメントが返すものと同じ数の一意に名前が付けられた変数が必要です。たとえば、SELECT が foo と bar を返す場合、このステートメントは変数として :foo および :bar のみを取る必要があります。ただし、ステートメントに同じ名前の変数を複数回適用することができます。

    SQL クエリーには、JOIN、ON およびデータベースがサポートするその他の句を含めることができます。

  7. schema 要素または .schemaJdbcConfigurationBuilder() メソッドを追加し、複合キーまたは値の Protobuf スキーマ設定を追加します。

    1. package 属性または package() メソッドを使用してパッケージ名を指定します。
    2. message-name 属性または messageName() メソッドを使用して複合値を指定します。
    3. key-message-name 属性または keyMessageName() メソッドを使用して複合キーを指定します。
    4. スキーマで値内にキーが含まれている場合は、embedded-key 属性または embeddedKey() メソッドに true の値を設定します。
  8. 変更を設定に保存します。

6.10.3.1. SQL クエリーストアの設定
リンクのコピー

このセクションでは、person と address の 2 つのデータベーステーブルのデータを含む分散キャッシュを読み込む SQL クエリーキャッシュストアの設定例を説明します。

SQL ステートメント

次の例は、"person" テーブルと "address" テーブルの SQL データ定義言語 (DDL) ステートメントを示しています。例で説明されているデータ型は、PostgreSQL データベースに対してのみ有効です。

person テーブルの SQL ステートメント

CREATE TABLE Person (
  name VARCHAR(255) NOT NULL,
  picture BYTEA,
  sex VARCHAR(255),
  birthdate TIMESTAMP,
  accepted_tos BOOLEAN,
  notused VARCHAR(255),
  PRIMARY KEY (name)
);
Copy to Clipboard Toggle word wrap

address テーブルの SQL ステートメント

CREATE TABLE Address (
  name VARCHAR(255) NOT NULL,
  street VARCHAR(255),
  city VARCHAR(255),
  zip INT,
  PRIMARY KEY (name)
);
Copy to Clipboard Toggle word wrap

Protobuf スキーマ

person および address テーブルの Protobuf スキーマは以下のとおりです。

address テーブルの Protobuf スキーマ

package com.example;

message Address {
   optional string street = 1;
   optional string city = 2 [default = "San Jose"];
   optional int32 zip = 3 [default = 0];
}
Copy to Clipboard Toggle word wrap

person テーブルの Protobuf スキーマ

package com.example;

import "/path/to/address.proto";

enum Sex {
   FEMALE = 1;
   MALE = 2;
}

message Person {
   optional string name = 1;
   optional Address address = 2;
   optional bytes picture = 3;
   optional Sex sex = 4;
   optional fixed64 birthDate = 5 [default = 0];
   optional bool accepted_tos = 6 [default = false];
}
Copy to Clipboard Toggle word wrap

キャッシュ設定

以下の例では、JOIN 句を含む SQL クエリーを使用して、person テーブルおよび address テーブルから分散キャッシュを読み込みます。

XML

<distributed-cache>
  <persistence>
    <query-jdbc-store xmlns="urn:infinispan:config:store:sql:14.0"
                      dialect="POSTGRES"
                      shared="true" key-columns="name">
          <connection-pool driver="org.postgresql.Driver"
                            connection-url="jdbc:postgresql://localhost:5432/postgres"
                            username="postgres"
                            password="changeme"/>
      <queries select-single="SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = :name AND t2.name = :name"
        select-all="SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name"
        delete-single="DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name"
        delete-all="DELETE FROM Person; DELETE FROM Address"
        upsert="INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)"
        size="SELECT COUNT(*) FROM Person"
      />
      <schema message-name="Person"
              package="com.example"
              embedded-key="true"/>
    </query-jdbc-store>
  </persistence>
</distributed-cache>
Copy to Clipboard Toggle word wrap

JSON

{
  "distributed-cache": {
    "persistence": {
      "query-jdbc-store": {
        "dialect": "POSTGRES",
        "shared": "true",
        "key-columns": "name",
        "connection-pool": {
          "username": "postgres",
          "password": "changeme",
          "driver": "org.postgresql.Driver",
          "connection-url": "jdbc:postgresql://localhost:5432/postgres"
        },
        "queries": {
          "select-single": "SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = :name AND t2.name = :name",
          "select-all": "SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name",
          "delete-single": "DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name",
          "delete-all": "DELETE FROM Person; DELETE FROM Address",
          "upsert": "INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)",
          "size": "SELECT COUNT(*) FROM Person"
        },
        "schema": {
          "message-name": "Person",
          "package": "com.example",
          "embedded-key": "true"
        }
      }
    }
  }
}
Copy to Clipboard Toggle word wrap

YAML

distributedCache:
  persistence:
    queryJdbcStore:
      dialect: "POSTGRES"
      shared: "true"
      keyColumns: "name"
      connectionPool:
        username: "postgres"
        password: "changeme"
        driver: "org.postgresql.Driver"
        connectionUrl: "jdbc:postgresql://localhost:5432/postgres"
      queries:
        selectSingle: "SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = :name AND t2.name = :name"
        selectAll: "SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name"
        deleteSingle: "DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name"
        deleteAll: "DELETE FROM Person; DELETE FROM Address"
        upsert: "INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)"
        size: "SELECT COUNT(*) FROM Person"
      schema:
        messageName: "Person"
        package: "com.example"
        embeddedKey: "true"
Copy to Clipboard Toggle word wrap

ConfigurationBuilder

ConfigurationBuilder builder = new ConfigurationBuilder();
builder.persistence().addStore(QueriesJdbcStoreConfigurationBuilder.class)
      .dialect(DatabaseType.POSTGRES)
      .shared("true")
      .keyColumns("name")
      .queriesJdbcConfigurationBuilder()
         .select("SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = :name AND t2.name = :name")
         .selectAll("SELECT t1.name, t1.picture, t1.sex, t1.birthdate, t1.accepted_tos, t2.street, t2.city, t2.zip FROM Person t1 JOIN Address t2 ON t1.name = t2.name")
         .delete("DELETE FROM Person t1 WHERE t1.name = :name; DELETE FROM Address t2 where t2.name = :name")
         .deleteAll("DELETE FROM Person; DELETE FROM Address")
         .upsert("INSERT INTO Person (name,  picture, sex, birthdate, accepted_tos) VALUES (:name, :picture, :sex, :birthdate, :accepted_tos); INSERT INTO Address(name, street, city, zip) VALUES (:name, :street, :city, :zip)")
         .size("SELECT COUNT(*) FROM Person")
      .schemaJdbcConfigurationBuilder()
         .messageName("Person")
         .packageName("com.example")
         .embeddedKey(true);
Copy to Clipboard Toggle word wrap

6.10.4. SQL キャッシュストアに関するトラブルシューティング
リンクのコピー

SQL キャッシュストアに関する一般的な問題およびエラーと、そのトラブルシューティング方法を確認してください。 

ISPN008064: No primary keys found for table <table_name>, check case sensitivity
Copy to Clipboard Toggle word wrap

Data Grid は、以下の場合にこのメッセージをログに記録します。

  • データベーステーブルが存在しない。
  • データベーステーブル名は大文字と小文字が区別され、データベースプロバイダーに応じて、すべての小文字またはすべての大文字のいずれかである必要があります。
  • データベーステーブルにプライマリーキーが定義されていない。

この問題を解決するには、以下を行う必要があります。

  1. SQL キャッシュストア設定を確認し、既存のテーブルの名前を指定するようにしてください。
  2. データベーステーブル名が大文字/小文字の要件に準拠することを確認します。
  3. データベーステーブルに、適切な行を一意に識別するプライマリーキーがあることを確認します。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat