ナレッジベース
 

製品をチェック

無償トライアル:

無償トライアルへ

製品の情報と無償トライアルへ:

Ponparemall Data Cmdlets

Ponparemall データにリアルタイム連携可能なPowerShell Cmdlets。SQL Server などのDB と同感覚で使えるCmdlets でPonparemall の在庫、商品、受注などに簡単にアクセス。

記事の内容

関連記事

Ponparemall データをMySQL にレプリケーションするPowerShell スクリプト


PowerShell でシンプルなスクリプトを記述し、Ponparemall data をMySQL データベースにレプリケーション（複製）。

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

ponparemall ロゴ画像

Cmdlets

powershell ロゴ画像
MySQL ロゴ画像

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

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

Ponparemall に接続するには、ShopUrl、InventoryUserId、InventoryPassword、OrderUserId、OrderPassword、PaymentUserId、およびPaymentPassword が必要です。

Ponparemall へのアクセスの設定

Ponparemall には各API のId とPassword が必要です。取得するには、以下の手順に従ってください。

  • Ponparemall Manager にログインし、メニューの「各種申請」の「WebAPI利用申請」をクリックします。
  • Web API メニューの「WebAPIサービス利用申請」をクリックし、利用申請を行います。
  • 後日、Ponparemall から必要なId とPassword が送られてきます。

Ponparemall アカウントの認証

次の接続プロパティを設定して接続します。

  • ShopUrl：接続先のPonparemall Shop URL を設定。「http://storetst4.ponparemall.com/sample/」に含まれる「sample」の部分を入力します。
  • InventoryUserId：「在庫API」のユーザID を設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
  • InventoryPassword：「在庫API」のパスワードを設定。このプロパティは、Inventory テーブルにアクセスする場合に必要です。
  • OrderUserId：「受注API」のユーザID を設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
  • OrderPassword：「受注API」のパスワードを設定。このプロパティは、Orders テーブルにアクセスする場合に必要です。
  • PaymentUserId：「決済API」のユーザID を設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。
  • PaymentPassword：「決済API」のパスワードを設定。このプロパティは、Payments テーブルにアクセスする場合に必要です。

Ponparemall データの取得

  1. モジュールのインストール:

    Install-Module PonparemallCmdlets

  2. Ponparemall への接続:

    $ponparemall = Connect-Ponparemall -InventoryUserId $InventoryUserId -InventoryPassword $InventoryPassword

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

    $data = Select-Ponparemall -Connection $ponparemall -Table "Orders"

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

    $data = Invoke-Ponparemall -Connection $ponparemall -Query 'SELECT * FROM Orders WHERE DateRangeSearchColumn = @DateRangeSearchColumn' -Params @{'@DateRangeSearchColumn'='2'}

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

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

Ponparemall データをMySQL データベースに入れます

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

  1. モジュールのインストール:

    Install-Module MySQLCmdlets

  2. MySQL DB に、MySQL Server 名、ユーザー、パスワード、レプリケーション先のデータベース名を指定して、接続します:

    $mysql = Connect-MySQL -User $User -Password $Password -Database $Database -Server $Server -Port $Port

  3. Ponparemall、保存された値、そしてAdd-MySQL Cmdlet を使って、MySQL にデータを1レコードずつ挿入します。この例では、MySQL 側のテーブルは、Ponparemall のリソース（Orders）と同じテーブル名を持っている必要があります。

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

これで、Ponparemall データをMySQL に複製できました。これで、分析、BI などでPonparemall データをMySQL から使うことができるようになります。

Notes

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

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

  • 別のPowerShell モジュールで、Ponparemall を別のデータベースに複製する場合、Select-Ponparemall cmdlet のデータから、カラム、接続およびテーブルを除外する方がいいでしょう。これらのデータは、CData cmdlet からデータを移動する際にのみ必要なものだからです。:

    $columns = ($data | Get-Member -MemberType NoteProperty | Select-Object -Property Name).Name | ? {$_ -NotIn @('Columns','Connection','Table')}