SQL 構文
Windows インストーラーの SQL クエリ文字列は、次の形式に制限されています。
| アクション | クエリ |
|---|---|
| レコードのグループを選択する | SELECT [DISTINCT]{column-list} FROM {table-list} [WHERE {operation-list}] [ORDER BY {column-list}] |
| テーブルからレコードを削除する | DELETE FROM {table} [WHERE {operation-list}] |
| テーブル内の既存のレコードを変更する | UPDATE {table-list} SET {column}= {constant} [, {column}= {constant}][, ...] [WHERE {operation-list}] UPDATE クエリは、非主キー列でのみ機能します。 |
| テーブルにレコードを追加する | INSERT INTO {table} ({column-list}) VALUES ({constant-list}) [TEMPORARY] バイナリ データは、INSERT INTO クエリまたは UPDATE SQL クエリを使用して、テーブルに直接挿入することはできません。 詳細については、「SQL を使用してテーブルにバイナリ データを追加する」を参照してください。 |
| テーブルの追加 | CREATE TABLE {table} ( {column} {column type}) [HOLD] テーブルを追加するときには、列ごとに列の型を指定する必要があります。 新しいテーブルを作成するには、少なくとも 1 つの主キー列を指定する必要があります。 上記の {column type} で置換できる値は、次のとおりです。CHAR [( {size} )] | CHARACTER [( {size} )] | LONGCHAR | SHORT | INT | INTEGER | LONG | OBJECT [NOT NULL] [TEMPORARY] [LOCALIZABLE] [, column...][, ...] PRIMARY KEY column [, column][, ...]。 |
| テーブルを削除する | DROP TABLE {table} |
| 列を追加する | ALTER TABLE {table} ADD {column} {column type} 列を追加するときには、列の型を指定する必要があります。 上記の {column type} で置換できる値は、次のとおりです。CHAR [( {size} )] | CHARACTER [( {size} )] | LONGCHAR | SHORT | INT | INTEGER | LONG | OBJECT [NOT NULL] [TEMPORARY] [LOCALIZABLE] [HOLD]。 |
| 一時テーブルを保持および解放する | ALTER TABLE {table name} HOLDALTER TABLE {table name} FREE ユーザーは、HOLD コマンドと FREE コマンドを使用して、一時テーブルまたは一時列の有効期間を制御できます。 テーブルでの保持カウントは、そのテーブルに対する SQL HOLD 操作ごとに増加し、テーブルに対する SQL FREE 操作ごとに減少します。 テーブルで最後の保持カウントが解放されると、すべての一時列にアクセスできなくなります。 すべての列が一時的である場合は、テーブルにアクセスできなくなります。 |
詳細については、「SQL とスクリプトを使用したデータベース クエリの例」を参照してください。
SQL 文法
省略可能なパラメーターは、角かっこ [ ] で囲まれて表示されます。 複数の選択肢が記載されている場合、省略可能なパラメーターは、縦棒で区切られます。
{constant} は、文字列または整数のいずれかです。 文字列は、'example' のように単一引用符で囲む必要があります。 {constant-list} は、1 つ以上の定数のコンマ区切りのリストです。
LOCALIZABLE オプションは、列をローカライズする必要があることを示す列属性を設定します。
{column} は、テーブルのフィールド内の値への列参照です。
{marker} は、クエリで送信されたレコードによって指定される値へのパラメーター参照です。 SQL ステートメントでは、疑問符 ? によって表されます。 パラメーターの使用については、MsiViewExecute 関数または Execute メソッドのいずれかを参照してください。
Windows インストーラー SQL 構文では、文字列リテラルでの単一引用符 (ASCII 値 39) のエスケープはサポートされていません。 ただし、レコードをフェッチまたは作成し、StringData プロパティまたは IntegerData プロパティを使用してフィールドを設定してから、Modify メソッドを呼び出すことができます。 または、レコードを作成し、Execute メソッドで説明されているパラメーター マーカー (?) を使用することができます。 これは、データベース関数 MsiViewExecute、MsiRecordSetInteger、MsiRecordSetString を使用して行うこともできます。
WHERE {operation-list} 句は、省略可能であり、選択範囲をフィルター処理するために使用される演算のグループです。 演算は、次の種類である必要があります。
- {column} = {column}
- {column} = | <> | > | < | >= | <= {constant}
- {column} = | <> | > | < | >= | <= {marker}
- {column} is null
- {column} is not null
文字列値の場合は、= 演算または <> 演算のみが可能です。 オブジェクト値の比較は、IS NULL と IS NOT NULL に制限されています。
個々の演算は、AND 演算子または OR 演算子によってグループ化できます。 順序付けは、かっこ ( ) を使用して適用できます。
ORDER BY 句は、省略可能であり、並べ替え中に最初の遅延を発生させます。 文字列によって順序付けすると、同じ文字列がまとめてグループ化されますが、文字列がアルファベット順に並べられることはありません。
DISTINCT 句は、省略可能であり、返された結果セット内で同じレコードを繰り返しません。
{table-list} は、結合内で {table} として参照される 1 つ以上のテーブル名のコンマ区切りのリストです。
{column-list} は、選択された {column} として参照される 1 つ以上のテーブル列のコンマ区切りのリストです。 あいまいな列は、{tablename.column} としてさらに修飾できます。 SELECT クエリでは、参照されたテーブル内のすべての列を表す column-list としてアスタリスクを使用できます。 列の位置によってフィールドを参照する場合は、アスタリスクを使用するのではなく、名前によって列を選択します。 INSERT INTO クエリでは、column-list としてアスタリスクを使用することはできません。
SQL キーワードと競合するテーブル名と列名をエスケープするには、名前を 2 つのアクサン グラーブ記号 '' (ASCII 値 96) で囲みます。 {tablename.column} として修飾されている列名をエスケープする必要がある場合は、テーブルと列を {'tablename'.'column'} として個別にエスケープする必要があります。 予約語との競合を回避し、パフォーマンスを大幅に向上させるには、この方法ですべてのテーブル名と列名をエスケープすることをお勧めします。
テーブル名は 31 文字までに制限されています。 詳細については、「テーブル名」を参照してください。 テーブル名と列名では大文字と小文字が区別されます。 SQL キーワードでは大文字と小文字が区別されません。
SQL クエリの WHERE 句での式の最大数は、32 に制限されています。
内部結合のみがサポートされ、異なるテーブルからの列の比較によって指定されます。 循環結合はサポートされていません。 循環結合は、3 つ以上のテーブルをまとめて 1 つの循環としてリンクする SQL クエリです。 たとえば、次の例は循環結合です。
WHERE Table1.Field1=Table2.Field1 AND Table2.Field2=Table3.Field1 AND Table3.Field2=Table1.Field2.
最初にテーブルの主キーの一部である列を優先順に定義し、非主キー列がある場合はその後に定義する必要があります。 永続的な列は、一時列の前に定義する必要があります。 テキスト列の並べ替え順序は未定義です。ただし、同じテキスト値は常にまとめてグループ化されます。
列を追加または作成するときには、列の型を指定する必要があることに注意してください。
テーブルに 'object' 型の列を複数含めることはできません。
SQL クエリ内の文字列列に対して明示的に指定できる最大サイズは、255 です。 長さが無限である文字列列は、サイズ 0 として表されます。 詳細については、「列定義の形式」を参照してください。
SQL ステートメントを実行するには、ビューを作成する必要があります。 ただし、CREATE TABLE や INSERT INTO など、結果セットを作成しないビューは、MsiViewModify メソッドまたは Modify メソッドと共に使用して、ビューを通じてテーブルを更新することはできません。
バイナリ データが含まれているレコードを 1 つのデータベースからフェッチしてから、そのレコードを使用してデータをまったく異なるデータベースに挿入することはできないことに注意してください。 バイナリ データを 1 つのデータベースから別のデータベースに移動するには、クエリと MsiRecordSetStream 関数を通じて、データをファイルにエクスポートしてから、それを新しいデータベースにインポートする必要があります。 これにより、各データベースがバイナリ データの独自のコピーを持つようになります。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示