Lesson 7 SQL
1. データベースを作成する
SQL データベースを作成するためには、最初に適切な資格を持ったユーザーが必要です。 そのユーザーの名前とパスワードはプロパティに保存されますので、 何らかの通常の UI 要素やカスタム・アクションを使って、設定することが出来ます。 これは、新しいユーザー・アカウントを作成する ために使ったのと同じ User タグであることに注意して下さい。 ただし、そのときは、Component タグの中で使われていました。 どのコンポーネントにも属さないときは、User タグはユーザーを作成せず、他の操作が必要とする資格を定義するだけです。 ここで使うタグも、SQL 関連の機能も、拡張モジュールの中にありますので、ソース・ファイルの開始タグの中で、 それらの拡張モジュールに言及しなければなりません。
<Wix xmlns='http://schemas.microsoft.com/wix/2006/wi'
xmlns:util='http://schemas.microsoft.com/wix/UtilExtension'
xmlns:sql='http://schemas.microsoft.com/wix/SqlExtension'>更に、それらのタグは独自のネームスペースに属していますので、使用するときには修飾を加えなければなりません。
<util:User Id='SQLUser' Name='[SQLUSER]' Password='[SQLPASSWORD]' />データベースの作成そのものは、いつものように、コンポーネントの中に入ります。 SqlDatabase は前の User の宣言を参照し、データベース名 (サーバーとインスタンス) を定義します。 Server を指定しない場合は、ターゲット・マシンで走っている SQL サーバーにデータベースをインストールすることになります。 その他の属性は、さまざまに異なる状況で、どのように進むべきかを指定します。 ConfirmOverwrite は、データベースが既に存在する場合にどうするかを決定し、 CreateOnInstall, CreateOnUninstall, DropOnInstall, DropOnUninstall の属性はインストールおよびアンインストールの際に要求される振る舞いを指図します。
入れ子にされた SqlScript タグは、作成されたばかりの空のデータベースに対して何をするべきかを決定します。 私たちは、ここで、独立したファイルに入っている SQL スクリプトを、妥当なものなら何でも、実行することが出来ます。 BinaryKey 属性が .sql ファイルへのリンクを提供します。 その他の属性は、エラーが発生したときの振る舞いを指定したり (ContinueOnError)、 スクリプトを実行する時を指定したりします (ExecuteOnInstall, ExecuteOnUninstall, RollbackOnInstall, RollbackOnUninstall)。 実行されるスクリプトが複数有る場合は、Sequence 属性を使って、実行の順序を指定する事が出来ます。
<Component Id='SqlComponent'
Guid='YOURGUID-D8C7-4102-BA84-9702188FA316'>
<sql:SqlDatabase Id='SqlDatabase' Database='Foobar'
User='SQLUser' Server='[SQLSERVER]' CreateOnInstall='yes'
DropOnUninstall='yes' ContinueOnError='yes'>
<sql:SqlScript Id='CreateTable' BinaryKey='CreateTable'
ExecuteOnInstall='yes' />
</sql:SqlDatabase>
</Component>残っているのは、.sql ファイルを含めることだけです。
<Binary Id='CreateTable' SourceFile='CreateTable.sql' />参照する .sql ファイルは、データベース・テーブルを作成するためのよくある SQL コマンドを記載したものです。
CREATE TABLE Test (Value1 CHAR(50), Value2 INTEGER)
CREATE INDEX TestIndex ON Test (Value1)インストーラ・パッケージをビルドする時は、適切な WiX モジュールとリンクしなければなりません。
candle.exe -ext WixUtilExtension -ext WixSqlExtension SampleSQL.wxs
light.exe -ext WixUtilExtension -ext WixSqlExtension SampleSQL.wixobj完全な SampleSQL をダウンロードすることが出来ます。
訳註：SampleSQL の日本語版は Sample-7-1-SQL.zip です。