接続の確立

CData Cmdlets ユーザーは、データモジュールをインストールし、接続プロパティを設定してスクリプトを開始できます。このセクションでは、CSV インポートおよびエクスポートcmdlet などのネイティブPowerShell cmdlet でDB2 Cmdlets を使用する例を示します。

インストールおよび接続

PSGet がある場合は、PowerShell Gallery から次のコマンドを使ってcmdlet をインストールできます。CData サイトからセットアップを取得することもできます。

Install-Module DB2Cmdlets

プロファイルに以下を追加すると、次のセッションでcmdlet がロードされます。

Import-Module DB2Cmdlets;

Connect-DB2 cmdlet を使って、別のcmdlet に渡すことができる接続オブジェクトを作成します。

$conn =

DB2 への接続

接続するには次のプロパティを設定します。

Server：DB2 を実行するサーバー名。
Port：DB2 サーバーがリッスンしているポート。
Database：DB2 データベース名。

DB2 への認証

本製品は、Watson Query などのDB2 と統合されたアプリケーションのAPI キーを使用する認証だけでなく、ユーザー資格情報によるDB2 への直接認証もサポートしています。

DB2 ユーザー資格情報

AuthScheme をUSRIDPWD に設定します。次の資格情報を設定します。

User：データベースへのアクセス権を持つユーザーのユーザー名。
Password：データベースへのアクセス権を持つユーザーのパスワード。

IAM

本製品は、Watson Query など、接続するアプリケーションのAPI キーを使用するDB2 サーバーへの認証もサポートしています。

AuthScheme をIBMIAMAuth に設定します。次の資格情報を設定します。

User：DB2 サーバーのユーザーに紐づくIBMid またはサービスID。
Password：DB2 データベースへのアクセスを必要とするアプリケーションに関連付けられたAPI キー。

データの取得

接続の作成が完了したら、リレーショナルデータベースに対して通常行える操作を別のcmdlet を使って実行できます。 Select-DB2 cmdlet はデータを取得するためのネイティブなPowerShell インターフェースを提供します。

$results = Select-DB2 -Connection $conn -Table ""Sample"."DB2INST1".Books" -Columns @("Id, Author") -Where "Category='US'"

Invoke-DB2 cmdlet はSQL インターフェースを提供します。このcmdlet を使うと、Query パラメータを介してSQL クエリを実行できます。

cmdlet 出力のパイプ処理

cmdlet は行オブジェクトをパイプラインに一度に一行ずつ返します。以下は、結果をCSV ファイルにエクスポートします。

Select-DB2 -Connection $conn -Table "Sample"."DB2INST1".Books -Where "Category = 'US'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\my"Sample"."DB2INST1".BooksData.csv -NoTypeInformation

Select-DB2 からの結果をSelect-Object cmdlet にパイプして、Export-CSV cmdlet にパイプする前にいくつかのプロパティを実行していることがわかるでしょう。これをする理由は、CData Cmdlets は接続、テーブル、およびカラムの情報を結果セットの各行オブジェクトに追加しますが、必ずしもその情報がCSV ファイルに必要ではないからです。

ただし、これによってcmdlet の出力を別のcmdlet にパイプすることが容易になります。以下に、結果セットをJSON に変換する例を示します。

 
PS C:\> $conn  = 
PS C:\> $row = Select-DB2 -Connection $conn -Table ""Sample"."DB2INST1".Books" -Columns (Id, Author) -Where "Category = 'US'" | select -first 1
PS C:\> $row | ConvertTo-Json
{
  "Connection":  {

  },
  "Table":  ""Sample"."DB2INST1".Books",
  "Columns":  [

  ],
  "Id":  "MyId",
  "Author":  "MyAuthor"
}

データの削除

以下は、抽出条件に合うあらゆるレコードを削除します。

Select-DB2 -Connection $conn -Table "Sample"."DB2INST1".Books -Where "Category = 'US'" | Remove-DB2

データの変更

cmdlet はデータクレンジング同様、データの変換を容易にします。次の例は、レコードがすでに存在するかどうか、挿入する前に更新が必要かどうかをチェックしてから、CSV ファイルのデータをDB2 にロードします。

Import-Csv -Path C:\My"Sample"."DB2INST1".BooksUpdates.csv | %{
  $record = Select-DB2 -Connection $conn -Table "Sample"."DB2INST1".Books -Where ("Id = `'"+$_.Id+"`'")
  if($record){
    Update-DB2 -Connection $conn -Table "Sample"."DB2INST1".Books -Columns @("Id","Author") -Values @($_.Id, $_.Author) -Where "Id  = `'$_.Id`'"
  }else{
    Add-DB2 -Connection $conn -Table "Sample"."DB2INST1".Books -Columns @("Id","Author") -Values @($_.Id, $_.Author)
  }
}

Cmdlets for DB2