標準PowerShell cmdlets を使ってGaroon テーブルにアクセスして、CSV にエクスポート。
CData Cmdlets Module for Garoon は、直感的なGaroon データ連携を提供する標準cmdlet です。 本記事では、Garoon Cmdlets を使ったサンプルを提供します。
Garoon への接続を設定
Garoon への認証は、パスワード認証、Basic 認証、クライアントSSL をサポートしています。
パスワード認証
Garoon への認証には、以下を設定する必要があります。
- Url:アカウントのURL。
- User:アカウントのユーザー名。
- Password:アカウントのパスワード。
Basic 認証
Basic 認証セキュリティ機能がドメインに設定されている場合は、BasicAuthUser とBasicAuthPassword の追加ログイン資格情報を指定します。Basic 認証ではUser とPassword に加えて、これらのクレデンシャルが必要です。
クライアントSSL
Basic 認証の代わりに、クライアント証明書を指定して本製品を認証できます。 SSLClientCert、SSLClientCertType、 SSLClientCertSubject、 およびSSLClientCertPassword を設定します。 さらに、User とPassword をGaroon のログイン資格情報に設定します。
$conn = Connect-Garoon -User "$User" -Password "$Password" -Url "$Url"
Garoon データを取得してCSV にパイプライン
次の手順で、Events テーブルデータを取得して、結果をCSV ファイルにエクスポートします:
Select-Garoon -Connection $conn -Table Events | Select -Property * -ExcludeProperty Connection,Table,Columns | Export-Csv -Path c:\myEventsData.csv -NoTypeInformation
このように、Select-Garoon から取得した結果を、Select-Object cmdlet に流し、Export-Csv cmdlet に渡す前にいくつかのプロパティを除外しています。これは、CData Cmdlets が接続情報、テーブル、およびカラム情報が結果セットのそれぞれの"行"に挿入されるためです。それらの情報を表示したくない場合に、Export-Csv cmdlet に渡す前に除外を先に行い、それからCSV ファイルにエクスポートします。。
CData Cmdlets から、次のCmdlets にデータをパイプラインするところでは、接続、テーブル、カラムの情報が必要です。データの削除
以下のように、指定に合致するレコードを削除することができます:
Select-Garoon -Connection $conn -Table Events -Where "CreatorName = Bob" | Remove-Garoon
データの挿入と更新
CData Cmdlets は、データの加工やクレンジングを行うことができます。以下の手順では、CSV ファイルのデータを、挿入対象のオブジェクトに同じレコードが存在するかを確認した上で、存在する場合にはデータの更新、存在しない場合にはデータの挿入を行います。
Import-Csv -Path C:\MyEventsUpdates.csv | %{ $record = Select-Garoon -Connection $Garoon -Table Events -Where ("Id = `'"+$_.Id+"`'") if($record){ Update-Garoon -Connection $garoon -Table Events -Columns ("Id","EventMenu") -Values ($_.Id, $_.EventMenu) -Where ("Id = `'"+$_.Id+"`'") }else{ Add-Garoon -Connection $garoon -Table Events -Columns ("Id","EventMenu") -Values ($_.Id, $_.EventMenu) } }
このように、CData Cmdlets でデータ連携をシンプルに構成できます。Cmdlets では、モジュールのインストール、接続プロパティの設定だけで、データ連携の構築を始めることができます。是非、CData PowerShell Cmdlets の無償試用版をダウンロードして、シンプルかつパワフルなデータ連携を体感してください。