接続の確立

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

SAP HANA Cloud への接続

データに接続するには以下を設定します。

Server：SAP HANA データベースインスタンスの名前またはネットワークアドレスに設定。
Port：443に設定。
UseSSL：Trueに設定。

SAP HANA On-Prem への接続

データに接続するには以下を設定します。

Server：SAP HANA データベースインスタンスの名前またはネットワークアドレスに設定。
Port：SAP HANA データベースをホスティングしているサーバーのポート。

SAP HANA への認証

接続の詳細を入力したら、次のデータベース資格情報を設定してSAP HANA に認証します。

User：SAP HANA データベースとの認証のためのユーザー名。
Password：SAP HANA データベースとの認証のためのパスワード。

Okta

AuthScheme をOkta に設定します。Okta への接続には、次の接続プロパティを使用します。

User： Okta ユーザーに設定。
Password：ユーザーのOkta パスワードに設定。
SSOProperties（オプション）：デバイスに送信されたOTP コードを設定。このプロパティは、OKTA サインオンのためにMFA が必要な場合にのみ使用します。

次のSSOProperties がOkta への認証に必要です。

SSOLoginUrl: OKTA のログインURL に設定。
MFAType（オプション）： multi-factor type に設定。このプロパティは、OKTA サインオンのためにMFA が必要な場合にのみ使用します。このプロパティには次の値の一つを受け付けます。
- OKTAVerify
- Email
- SMS
APIToken（オプション）： Okta org から作成したAPI Token に設定。Okta クライアントリクエストコンテキストを上書きする、信頼されたアプリケーションまたはプロキシ経由でユーザーを認証する場合に使用してください。

次は接続文字列の例です。

AuthScheme=OKTA;User=username;Password=password;Server=myserver;SSO Properties='SSOLoginUrl=https://cdata-okta.okta.com';

接続オブジェクトの作成

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

$conn = Connect-SAPHANA -User 'system' -Password 'myPassword' -Database 'systemdb' -Server 'myServer'

データの取得

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

$results = Select-SAPHANA -Connection $conn -Table ""SYSTEMDB"."DEMO".Products" -Columns @("Id, ProductName") -Where "ProductName='Konbu'"

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

cmdlet 出力のパイプ処理

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

Select-SAPHANA -Connection $conn -Table "SYSTEMDB"."DEMO".Products -Where "ProductName = 'Konbu'" | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\my"SYSTEMDB"."DEMO".ProductsData.csv -NoTypeInformation

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

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

 
PS C:\> $conn  = Connect-SAPHANA -User 'system' -Password 'myPassword' -Database 'systemdb' -Server 'myServer'
PS C:\> $row = Select-SAPHANA -Connection $conn -Table ""SYSTEMDB"."DEMO".Products" -Columns (Id, ProductName) -Where "ProductName = 'Konbu'" | select -first 1
PS C:\> $row | ConvertTo-Json
{
  "Connection":  {

  },
  "Table":  ""SYSTEMDB"."DEMO".Products",
  "Columns":  [

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

データの削除

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

Select-SAPHANA -Connection $conn -Table "SYSTEMDB"."DEMO".Products -Where "ProductName = 'Konbu'" | Remove-SAPHANA

データの変更

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

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

Cmdlets for SAP HANA