接続の確立

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

SybaseIQ への接続

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

Server：SybaseIQ またはSAP SQL Anywhere データベースインスタンスの名前またはネットワークアドレスに設定。
Database：指定されたサーバーで実行されているSybaseIQ またはSAP SQL Anywhere データベースの名前に設定。

オプションで、UseSSL をtrue に設定することにより、TLS/SSL で接続を保護できます。

Note： 上記の本製品設定でSAP SQL Anywhere のインスタンスに接続することもできます。

SybaseIQ への認証

SybaseIQ は、Basic 認証、Kerberos 認証、LDAP 認証などの認証方法をいくつかサポートしています。

Basic

Set the AuthScheme to Basic and set the following connection properties to use SybaseIQ authentication.

User：認証SybaseIQ ユーザーのユーザー名に設定。
Password：認証SybaseIQ ユーザーのパスワードに設定。

LDAP

LDAP 認証で接続するには、LDAP 認証メカニズムを使用するようにSybaseIQサーバーサイドを設定する必要があります。

LDAP 用にSybaseIQ を設定したら、Basic 認証と同じクレデンシャルを使用して接続できます。

Kerberos

Kerberos 認証を活用するには、次の接続プロパティを使用してそれを有効にすることから始めます。

AuthScheme：Set to Kerberos will be used for authentication to SybaseIQ.

Kerberos 認証用に設定する必要がある接続プロパティに関しては、Kerberos の使用情報を参照してください。

以下は接続文字列の例です。

Server=MyServer;Port=MyPort;User=SampleUser;Password=SamplePassword;Database=MyDB;Kerberos=true;KerberosKDC=MyKDC;KerberosRealm=MYREALM.COM;KerberosSPN=server-name

接続オブジェクトの作成

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

$conn = Connect-SybaseIQ -User 'myUser' -Password 'myPassword' -Database 'NorthWind' -Server 'myServer'

データの取得

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

$results = Select-SybaseIQ -Connection $conn -Table "[master].[dbo].Products" -Columns @("Id, ProductName") -Where "ProductName='Konbu'"

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

cmdlet 出力のパイプ処理

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

Select-SybaseIQ -Connection $conn -Table [master].[dbo].Products -Where "ProductName = 'Konbu'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\my[master].[dbo].ProductsData.csv -NoTypeInformation

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

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

 
PS C:\> $conn  = Connect-SybaseIQ -User 'myUser' -Password 'myPassword' -Database 'NorthWind' -Server 'myServer'
PS C:\> $row = Select-SybaseIQ -Connection $conn -Table "[master].[dbo].Products" -Columns (Id, ProductName) -Where "ProductName = 'Konbu'" | select -first 1
PS C:\> $row | ConvertTo-Json
{
  "Connection":  {

  },
  "Table":  "[master].[dbo].Products",
  "Columns":  [

  ],
  "Id":  "MyId",
  "ProductName":  "MyProductName"
}

データの削除

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

Select-SybaseIQ -Connection $conn -Table [master].[dbo].Products -Where "ProductName = 'Konbu'" | Remove-SybaseIQ

データの変更

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

Import-Csv -Path C:\My[master].[dbo].ProductsUpdates.csv | %{
  $record = Select-SybaseIQ -Connection $conn -Table [master].[dbo].Products -Where ("Id = `'"+$_.Id+"`'")
  if($record){
    Update-SybaseIQ -Connection $conn -Table [master].[dbo].Products -Columns @("Id","ProductName") -Values @($_.Id, $_.ProductName) -Where "Id  = `'$_.Id`'"
  }else{
    Add-SybaseIQ -Connection $conn -Table [master].[dbo].Products -Columns @("Id","ProductName") -Values @($_.Id, $_.ProductName)
  }
}

Cmdlets for SybaseIQ