Veeva のデータをPowerShell でMySQL にレプリケーションする方法

古川えりか
コンテンツスペシャリスト

PowerShell のシンプルなスクリプトで、Veeva のデータをMySQL データベースにレプリケーション（複製）する方法を紹介します。

CData Cmdlets for VaultCRM を使えば、PowerShell からVeeva のデータデータにリアルタイムで連携できます。データ同期などのタスクの連携にぴったりの製品です。本記事では、PowerShell からCData Cmdlets for VaultCRM およびCData Cmdlets for MySQL を使って、同期スクリプトを作成して実行します。

まずは、PowerShell でVeeva への接続を行います。レプリケーションは4つのステップがあります。

それでは、Veeva Vault アカウントに接続していきましょう。まずはUrl 接続プロパティにホスト名を設定します。ホスト名は、アカウントにログインした後にアドレスバーから確認できます。

例：https://myvault.veevavault.com

Veeva Vaultへの認証

続いて、認証方法を設定しましょう。CData 製品では、以下の認証方法をサポートしています。

Veeva Vault ユーザー資格情報
Azure AD 認証プロバイダーのOpenID Connect
Okta SSO

ユーザー資格情報

最も基本的な認証方法です。AuthScheme をBasic に設定し、User とPassword にユーザーログイン資格情報を設定してください。

その他の認証方法については、ヘルプドキュメントの「接続の確立」をご確認ください。

Veeva のデータの取得

モジュールのインストール:
```
Install-Module VaultCRMCmdlets
```

Veeva への接続:

  $vaultcrm = Connect-VaultCRM  -User $User -Password $Password -Server $Server -Database $Database

取得ターゲットのリソースの取得:

  $data = Select-VaultCRM -Connection $vaultcrm -Table "NorthwindProducts"

Invoke-VaultCRM cmdlet を使って、SQL-92 クエリを使用することもできます:

  $data = Invoke-VaultCRM -Connection $vaultcrm -Query 'SELECT * FROM NorthwindProducts WHERE CategoryId = @CategoryId' -Params @{'@CategoryId'='5'}

戻り値からカラム名のリストを保存します。

  $columns = ($data | Get-Member -MemberType NoteProperty | Select-Object -Property Name).Name

Veeva のデータをMySQL データベースにレプリケーション

カラム名を指定できるようにして、データをMySQL データベースにレプリケーションします。

モジュールのインストール:
```
Install-Module MySQLCmdlets
```
MySQL DB に、MySQL Server 名、ユーザー、パスワード、レプリケーション先のデータベース名を指定して、接続します:
```
  $mysql = Connect-MySQL -User $User -Password $Password -Database $Database -Server $Server -Port $Port
  
```
Veeva、保存された値、そしてAdd-MySQL Cmdlet を使って、MySQL にデータを1レコードずつ挿入します。この例では、MySQL 側のテーブルは、Veeva のリソース（NorthwindProducts）と同じテーブル名を持っている必要があります。
```
  $data | % {
    $row = $_
    $values = @()
    $columns | % {
      $col = $_
      $values += $row.$($col)
    }
    Add-MySQL -Connection $mysql -Table "NorthwindProducts" -Columns $columns -Values $values
  }
  
```

次回以降のレプリケーションをシンプルに実現

一度PowerShell でVeeva とMySQL に接続したら、次からは1行のコマンドでレプリケーションを実施できます:

  Select-VaultCRM -Connection $vaultcrm -Table "NorthwindProducts" | % {
    $row = $_
    $values = @()
    $columns | % {
      $col = $_
      $values += $row.$($col)
    }
    Add-MySQL -Connection $mysql -Table "NorthwindProducts" -Columns $columns -Values $values
  }

別のPowerShell モジュールで、Veeva を別のデータベースに複製する場合、Select-VaultCRM cmdlet のデータから、カラム、接続およびテーブルを除外しておきましょう。これらのデータはデータ移動のときだけ必要となるためです。
```
  $columns = ($data | Get-Member -MemberType NoteProperty | Select-Object -Property Name).Name | ? {$_ -NotIn @('Columns','Connection','Table')}
  
```