Tablestore SDK for Python を使用して、既存のデータテーブルまたは検索インデックス用のマッピングテーブルを作成し、データへの SQL アクセスを有効にできます。
前提条件
-
Tablestore SDK for Python をインストールし、クライアントを初期化します。
-
SQL クエリにはバージョン 5.4.2 以降が必要です。最新バージョンの使用を推奨します。
説明
Tablestore は、データテーブルの SQL マッピングテーブルを自動作成しません。SQL を使用してデータテーブルにアクセスするには、先に CREATE TABLE ステートメントを実行してマッピングテーブルを作成する必要があります。exe_sql_query メソッドを呼び出して CREATE TABLE ステートメントを実行し、既存のデータテーブルまたは検索インデックス用のマッピングテーブルを作成します。
def exe_sql_query(self, query)
データテーブルの場合、マッピングテーブルはデータテーブルと同じ名前である必要があります。フィールド名は大文字と小文字を区別せず、フィールド型はデータテーブルのフィールド型に対応している必要があります。検索インデックスの場合は、マッピングテーブル名をカスタマイズでき、ENGINE と ENGINE_ATTRIBUTE を使用してデータテーブルと検索インデックスを指定できます。
CREATE TABLE ステートメントの構文、フィールド型、パラメーターについては、DDL operations をご参照ください。
次の例は、example_table データテーブル用のマッピングテーブルを作成します。
query = """
CREATE TABLE example_table (
pk VARCHAR(1024), long_value BIGINT, double_value DOUBLE,
string_value MEDIUMTEXT, bool_value BOOL, PRIMARY KEY(pk)
)
"""
client.exe_sql_query(query)
パラメーター
exe_sql_query メソッドには、次のパラメーターが含まれます。
|
名前 |
タイプ |
説明 |
|
query (必須) |
String |
実行する |
シナリオ例
検索インデックス用マッピングテーブルの作成
ENGINE を searchindex に設定し、ENGINE_ATTRIBUTE でデータテーブルと検索インデックスを指定します。次の例では、example_table データテーブルの example_index 検索インデックスに対し、example_search_table マッピングテーブルを作成します。
query = """
CREATE TABLE example_search_table (
pk MEDIUMTEXT, long_value BIGINT, string_value MEDIUMTEXT
) ENGINE='searchindex'
ENGINE_ATTRIBUTE='{"index_name":"example_index","table_name":"example_table"}'
"""
client.exe_sql_query(query)
よくある質問
Table 'instance.table' doesn't exist エラーが返される
原因:指定したデータテーブルまたは検索インデックスが存在しません。CREATE TABLE ステートメントはマッピングテーブルのみを作成します。
解決策:名前を確認し、データテーブルまたは検索インデックスが存在することを確認してから、ステートメントを再実行してください。
Table 'instance.table' already exists エラーが返される
原因:マッピングテーブルがすでに存在します。これは CREATE TABLE ステートメントで作成されました。
解決策:重複作成エラーを防ぐには、IF NOT EXISTS を使用してください。マッピングテーブルのスキーマを変更するには、まず DESCRIBE ステートメントを実行してスキーマを確認し、その後 ALTER TABLE ステートメントを使用してマッピングテーブルを変更してください。