接続の確立
CData Cmdlets ユーザーは、データモジュールをインストールし、接続プロパティを設定してスクリプトを開始できます。このセクションでは、CSV インポートおよびエクスポートcmdlet などのネイティブPowerShell cmdlet でSybaseIQ Cmdlets を使用する例を示します。
インストールおよび接続
PSGet がある場合は、PowerShell Gallery から次のコマンドを使ってcmdlet をインストールできます。CData サイトからセットアップを取得することもできます。
Install-Module SybaseIQCmdlets
プロファイルに以下を追加すると、次のセッションでcmdlet がロードされます。
Import-Module SybaseIQCmdlets;
Connect-SybaseIQ cmdlet を使って、別のcmdlet に渡すことができる接続オブジェクトを作成します。
$conn = Connect-SybaseIQ -User 'myUser' -Password 'myPassword' -Database 'NorthWind' -Server 'myServer'
SybaseIQ への接続
SybaseIQ に接続するには、次の接続プロパティを指定します。
- Server:SybaseIQ またはSAP SQL Anywhere データベースインスタンスの名前またはネットワークアドレスに設定。
- Database:指定されたサーバーで実行されているSybaseIQ またはSAP SQL Anywhere データベースの名前に設定。
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.
以下は接続文字列の例です。
Server=MyServer;Port=MyPort;User=SampleUser;Password=SamplePassword;Database=MyDB;Kerberos=true;KerberosKDC=MyKDC;KerberosRealm=MYREALM.COM;KerberosSPN=server-name
データの取得
接続の作成が完了したら、リレーショナルデータベースに対して通常行える操作を
別の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) } }