接続の確立
CData Cmdlets ユーザーは、データモジュールをインストールし、接続プロパティを設定してスクリプトを開始できます。このセクションでは、CSV インポートおよびエクスポートcmdlet などのネイティブPowerShell cmdlet でSAPHanaXSA Cmdlets を使用する例を示します。
インストールおよび接続
PSGet がある場合は、PowerShell Gallery から次のコマンドを使ってcmdlet をインストールできます。CData サイトからセットアップを取得することもできます。
Install-Module SAPHanaXSACmdlets
プロファイルに以下を追加すると、次のセッションでcmdlet がロードされます。
Import-Module SAPHanaXSACmdlets;
Connect-SAPHanaXSA cmdlet を使って、別のcmdlet に渡すことができる接続オブジェクトを作成します。
$conn = Connect-SAPHanaXSA -OAuthClientID "MyOAuthClientID" -OAuthClientSecret "MyOAuthClientSecret" -URL "https://hxehost:51027/euro.xsodata" -CallbackURL "http://localhost:33333"
SAP HANA XSA はOAuth 認証標準を利用しています。接続する前に、SAP HANA XSA OData サービスを確立する必要があります。カスタムOAuth アプリの作成 を参照してください。
OAuthPassword グラント種別を使用してSAP HANA XSA に接続するには、以下を設定します。
- OAuthClientId:UAA サービスJSON ファイルで指定されたClient Id に設定。
- OAuthClientSecret:UAA サービスJSON ファイルで指定されたClient Secret に設定。
- Url:OData サービスエンドポイントに設定。
- XSUAAURL:UAA サービスURL に設定。
- User:アカウントのユーザー名に設定。
- Password:アカウントのパスワードに設定。
OData サービスを設定したら、カスタムクレデンシャル を使用して接続を確立できます。
データの取得
Select-SAPHanaXSA cmdlet はデータを取得するためのネイティブなPowerShell インターフェースを提供します。
$results = Select-SAPHanaXSA -Connection $conn -Table "SampleTable" -Columns @("Id, Column1") -Where "Column2='Bob'"Invoke-SAPHanaXSA cmdlet はSQL インターフェースを提供します。このcmdlet を使うと、Query パラメータを介してSQL クエリを実行できます。
cmdlet 出力のパイプ処理
cmdlet は行オブジェクトをパイプラインに一度に一行ずつ返します。以下は、結果をCSV ファイルにエクスポートします。
Select-SAPHanaXSA -Connection $conn -Table SampleTable -Where "Column2 = 'Bob'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\mySampleTableData.csv -NoTypeInformation
Select-SAPHanaXSA からの結果をSelect-Object cmdlet にパイプして、Export-CSV cmdlet にパイプする前にいくつかのプロパティを実行していることがわかるでしょう。これをする理由は、CData Cmdlets は接続、テーブル、およびカラムの情報を結果セットの各行オブジェクトに追加しますが、必ずしもその情報がCSV ファイルに必要ではないからです。
ただし、これによってcmdlet の出力を別のcmdlet にパイプすることが容易になります。以下に、結果セットをJSON に変換する例を示します。
PS C:\> $conn = Connect-SAPHanaXSA -OAuthClientID "MyOAuthClientID" -OAuthClientSecret "MyOAuthClientSecret" -URL "https://hxehost:51027/euro.xsodata" -CallbackURL "http://localhost:33333" PS C:\> $row = Select-SAPHanaXSA -Connection $conn -Table "SampleTable" -Columns (Id, Column1) -Where "Column2 = 'Bob'" | select -first 1 PS C:\> $row | ConvertTo-Json { "Connection": { }, "Table": "SampleTable", "Columns": [ ], "Id": "MyId", "Column1": "MyColumn1" }
データの削除
以下は、抽出条件に合うあらゆるレコードを削除します。
Select-SAPHanaXSA -Connection $conn -Table SampleTable -Where "Column2 = 'Bob'" | Remove-SAPHanaXSA
データの変更
cmdlet はデータクレンジング同様、データの変換を容易にします。次の例は、レコードがすでに存在するかどうか、挿入する前に更新が必要かどうかをチェックしてから、CSV ファイルのデータをSAP HANA XSA にロードします。
Import-Csv -Path C:\MySampleTableUpdates.csv | %{ $record = Select-SAPHanaXSA -Connection $conn -Table SampleTable -Where ("Id = `'"+$_.Id+"`'") if($record){ Update-SAPHanaXSA -Connection $conn -Table SampleTable -Columns @("Id","Column1") -Values @($_.Id, $_.Column1) -Where "Id = `'$_.Id`'" }else{ Add-SAPHanaXSA -Connection $conn -Table SampleTable -Columns @("Id","Column1") -Values @($_.Id, $_.Column1) } }