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

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

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

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

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

Stripeへの接続

それでは、Stripe への接続について説明していきましょう。Stripe では、本番API キーまたはOAuth のいずれかによる認証をサポートしています。

本番API キー

本番API キーで接続するには、以下の2つの設定パラメータを設定する必要があります。

AuthScheme = APIKey
LiveAPIKey = 本番API キーの値

本番API キーの値を取得するには、以下の手順で確認できます：

Stripe ダッシュボードにログインします
開発者 → API キー → シークレットキー → 本番環境のキーを表示 に移動します

Stripe では、テストモードで作成されたシークレットキーを使用して、'StripeV2' データモデルのエンティティにはアクセスできませんのでご注意ください。ライブモードまたはサンドボックスモードで作成されたシークレットキーをご利用ください。さらに、制限付きキーを使用して'StripeV2' データモデルのエンティティにアクセスすることも許可されていません。

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

Stripe のデータの取得

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

Stripe への接続:

  $stripe = Connect-Stripe  -OAuthClientId $OAuthClientId -OAuthClientSecret $OAuthClientSecret -CallbackURL $CallbackURL

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

  $data = Select-Stripe -Connection $stripe -Table "Customers"

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

  $data = Invoke-Stripe -Connection $stripe -Query 'SELECT * FROM Customers WHERE Delinquent = @Delinquent' -Params @{'@Delinquent'='False'}

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

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

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

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

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

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

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

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

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