クイックスタート

このページをシェアする

クイックスタート

ここでは、Pervasive PSQL データプロバイダーをインストールした後で、データベースに接続する基本的な操作について説明します。データプロバイダーの機能を最大限利用するには、このマニュアルのほかの章もお読みください。

サポートされる .NET Framework のバージョン

表 1 は、データプロバイダーでサポートされる .NET Framework バージョンの一覧を示しています。

表 1 サポートされる Microsoft .NET Framework のバージョン
データプロバイダーのバージョン	.NET Framework のバージョン
32 ビット ADO.NET データプロバイダー	バージョン 2.0、3.0、3.5、3.5 SP1、および 4.0（x86）
32 ビット ADO.NET Entity Framework データプロバイダー	バージョン 3.5 SP1 および 4.0（x86）
64 ビット ADO.NET データプロバイダー	バージョン 2.0、3.0、3.5、3.5 SP1、および 4.0（x64）
64 ビット ADO.NET Entity Framework データプロバイダー	バージョン 3.5 SP1 および 4.0（x64）

標準の ADO.NET を使用しているのであれば、以前のバージョンの .NET Framework および Pervasive PSQL データプロバイダー用に書かれた既存のコードは、バージョン 4.0 データプロバイダーと互換性があります。上位互換性のためには、.NET Framework バージョン 3.5 SP1 を使ってアプリケーションを再コンパイルする必要があることに注意してください。

基本的な接続文字列の定義

データプロバイダーでは、特定のデータベースサーバーへの接続に必要な情報の指定に接続文字列を使用します。この接続情報は接続文字列オプションで定義されます。

ADO.NET Entity Framework データプロバイダーは、Entity Framework ウィザードで既存の接続を指定するか、または新しい接続を定義することができます。ADO.NET Entity Framework は接続文字列に含まれている情報を使用して、基となる Entity Framework をサポートする ADO.NET データプロバイダーに接続します。接続文字列には、必要なモデルおよびマッピングファイルに関する情報も含まれています。データプロバイダーは、モデルにアクセスしたり、メタデータをマップしたり、データソースに接続したりする場合に接続文字列を使用します。

接続文字列オプションは次のような形式です。

"オプション名=値"

接続文字列オプション値の各ペアはセミコロンで区切ります。たとえば、次のようになります。

"Server DSN=DEMODATA;UID=test;PWD=test;Host=localhost"

サポートされるすべての接続文字列オプションの詳細については、表 26 を参照してください。

メモ：

•接続文字列オプション名内のスペースは任意です。

•接続文字列オプションでは大文字と小文字が区別されません。たとえば、User ID と user id は同じです。ただし、User ID や Password などいくつかのオプションの値の中には大文字と小文字が区別されるものもあります。

•接続文字列にポート番号が指定されていない場合、データプロバイダーは 1583 を使用します。これはデフォルトのポート番号です。

表 2 は、Pervasive PSQL サーバーへの接続に必要な最低限のオプションの名前とその説明です。

表 2 最低限必要な接続文字列オプション
オプション	説明
Server DSN	接続するサーバーのデータソース名を、DEMODATA のように指定します。
Host	接続する Pervasive PSQL サーバーの名前または IP アドレスを指定します。たとえば、Accountingserver などのサーバー名や、199.226.22.34（IPv4）または 1234:5678:0000:0000:0000:0000:9abc:def0（IPv6）などの IP アドレスを指定できます。デフォルトの初期値は localhost です。

データベースへの接続

データプロバイダーをインストールすると、接続文字列を使ってアプリケーションからデータベースに接続できるようになります。接続文字列オプションの一覧については、表 26 を参照してください。

メモ：アプリケーションで ADO.NET Entity Framework を使用する場合は、Entity Data Model ウィザードを使って新しい接続を作成したり、既存の接続を使用したりすることができます。詳細については、モデルの作成を参照してください。

例：プロバイダー固有のオブジェクトの使用

次の例はプロバイダー固有のオブジェクトを使用した例です。C# を使って Visual Studio で開発したアプリケーションから ADO.NET データプロバイダーを使用してデータベースに接続しています。

1 ソリューションエクスプローラーで［参照設定］を右クリックします。

2 ［参照の追加］をクリックし、コンポーネントリストから "Pervasive PSQL Data Provider" を選択します。このデータプロバイダーがコンポーネントリストにない場合は、［参照］タブをクリックしてデータプロバイダーアセンブリがあるディレクトリへ移動します。

3 ［OK］をクリックします。これで、ソリューションエクスプローラーに Pervasive PSQL データプロバイダーが含まれました。

4 次の C# コード例のように、データプロバイダーの名前空間をアプリケーションの先頭に追加します。

// Pervasive PSQL へアクセスする

using System.Data;

using System.Data.Common;

using Pervasive.Data.SqlClient;

5 サーバーの接続情報と例外処理のコードを追加します。

PsqlConnection DBConn = new PsqlConnection("Server DSN=DEMODATA;Host=localhost");

try

{

// 接続を開く

Conn.Open();

Console.WriteLine("接続成功!")

}

catch(PsqlException ex)

{

// 接続に失敗

writer.WriteLine(ex.Message);

}

// 接続を閉じる

Conn.Close();

6 接続を閉じます。

// 接続を閉じる

DBConn.Close();

例：共通プログラミングモデルの使用

次の例は、C# と共通プログラミングモデルを使用して Visual Studio で開発したアプリケーションから Pervasive PSQL データベースに接続する方法を示します。

1 アプリケーションの先頭部分を調べます。ADO.NET 名前空間が記述されていることを確認します。

// ファクトリを使用して Pervasive にアクセスします

using System.Data;

using System.Data.Common;

2 サーバーの接続情報および例外処理のコードを追加し、接続を閉じます。

DbProviderFactory

factory = DbProviderFactories("Pervasive.Data.SqlClient");

DbConnection Conn = factory.createConnection();

Conn.CommandText = "Server DSN=DEMODATA;Host=localhost;";

try

{

Conn.Open();

Console.WriteLine("接続成功!");

}

catch (Exception ex)

{

// 接続に失敗しました

Console.WriteLine(ex.Message);

}

// 接続を閉じます

Conn.Close();

例：Pervasive Common Assembly の使用

共通プログラミングモデルに適合するアプリケーションで Pervasive Bulk Load などの機能を使用したい場合は、Pervasive Common Assembly を含めることを選択できます。アプリケーションで Pervasive Bulk Load ユーザーを使用する方法については、Pervasive Bulk Load の使用を参照してください。

次の例は、C# と共通プログラミングモデルを使用して Visual Studio で開発したアプリケーションで Pervasive Common Assembly を使用する方法を示します。

1 アプリケーションの先頭部分を調べます。.NET Framework および Pervasive PSQL データプロバイダーの名前空間が記述されていることを確認します。

// ファクトリを使用して Pervasive PSQL にアクセスします

using System.Data;

using System.Data.Common;

using Pervasive.Data.Common;

2 サーバーの接続情報および例外処理のコードを追加し、接続を閉じます。

// このコードは、バルクコピー操作を Pervasive PSQL

// データベースから別のデータベースに対して行います

DbProviderFactory Factory = DbProviderFactories.GetFactory("Pervasive.Data.SqlClient");

DbConnection sourceConnection = Factory.CreateConnection();

sourceConnection.ConnectionString = "Host=localhost;Server DSN=DEMODATA;";

sourceConnection.Open();

DbCommand command = sourceConnection.CreateCommand();

command.CommandText = "SELECT * FROM test";

DbDataReader reader = command.ExecuteReader();

DbConnection destinationConnection = Factory.CreateConnection();

destinationConnection.ConnectionString = "Host= ntsl2003b;Server DSN=DEMODATA";

destinationConnection.Open();

DbBulkCopy bulkCopy = new DbBulkCopy(destinationConnection);

bulkCopy.DestinationTableName = "test";

try

{

bulkCopy.WriteToServer(reader);

}// 試行終了

catch (DbException ex)

{

Console.WriteLine(ex.Message);

}//catch の終了

finally

{

reader.Close();

MessageBox.Show("終了");

}//完了

ADO.NET Entity Framework データプロバイダーの使用

Entity Data Model ウィザードは、エンティティデータモデル（EDM）でコンポーネントを定義するための質問をします。その後、ウィザードは Visual Studio でデータのモデルを作成し、そのモデルでコンポーネントの値を自動的に設定します。ウィザードによる EDM の作成方法については、.edmx ファイルの使用を参照してください。

別の方法としては、Visual Studio でほかのツールを使って、値と接続文字列を手動で定義することもできます。

Provider は、EDM のストレージモデルファイルに含まれる Schema 要素の属性です。ストレージモデルファイルは、ストアスキーマ定義言語（SSDL）で書かれています。

Entity Data Model ウィザードは、Pervasive PSQL ADO.NET Entity Framework データプロバイダーが選択されているとき、値の割り当てを行います。エンティティデータモデルを手動で定義することを選ぶ場合は、次の例で示すように、文字列 Pervasive.Data.SqlClient を Schema 要素の Provider 属性に代入します。