Page History

...

Transformation Flow（データ変換フロー）内でのPFAモデルの使用

パート2：Transformation Flow（データ変換フロー）内でのRスクリプトの使用

R スクリプトを使用して、データへ適用するためには、以下の手順に従います。

1. 上記すべての前提条件を満たしていることを確認します。
2. 高度な分析モデルを構築し、PFA形式でこれを保存します。ファイルタイプはJSON、もしくはYAMLです（説明の中ではこのファイルを、PFAファイルと言います）。
3. Yellowfinのデータ変換モジュールへ移動します。（「作成」ボタン＞「Transformation Flow（データ変換フロー）」）
4. データを取得するInput Step（入力ステップ）から、Transformation Flow（データ変換フロー）の作成を始めます。（基礎的なフローの作成方法は、こちらを参照してください。また、他のデータの取得方法については、こちらを参照してください）
   
   
   
   
5. 取得されたデータが、データプレビューパネルに表示されます。さらにデータを変換するために、Step（ステップ）を追加することもできます。
6. PAF Step（ステップ）を使用してデータサイエンスモデルをインポートする準備が整ったら、以下の手順に従います。
Transformation Step（変換ステップ）一覧から、PFA Step（ステップ）をキャンバスへドラッグします。（PFA Step（ステップ）アイコンは、初めてドラッグされた際に、デフォルトで赤く表示されるようになっています。これは、Step（ステップ）が設定されていないことを示すためです）

7. Rスクリプトを使用する準備が整ったら、以下の手順に従います。

8. Transformation Step（変換ステップ）一覧から、Rスクリプト Step（ステップ）をキャンバスへドラッグします。（注意：こちらのStep（ステップ）が表示されない場合は、Rのプラグインがインストールされていることを確認してください）
   
   

   Image Added

    

9. Connection（接続）ポイントを使用して、最後のStep（ステップ）をRスクリプト Step（ステップ）へ接続します。
   
   Image Added
   
   

10. R Step（ステップ）の設定をします。（設定詳細が表示されるように選択されていることを確認してください）
    
    

    Note
    YellowfinはRserveパッケージを利用します。接続を試行する前に、Rserveをインストールし、実行しなくてはいけません。

    
    Image Added

11. Rインスタンスへ接続するためには、ローカルアクセス（手順10へ進む）、またはリモートアクセス（手順11へ進む）の2つのオプションがあります。
12. ローカルのRインスタンスへの接続：Rserveがローカル端末上にインストールされている場合、こちらのオプションを選択します。
    
    1. こちらのオプションでは、「Connect to Rserve（Rserveへ接続）」ボタンをクリックします。（パラメーターの提供は必要ありません）
    2. 接続に成功すると、必要な設定情報が表示されます。（手順12へ進む）
    3. しかし、接続試行中に以下のエラーが表示された場合は、Rserveが適切に起動していないことを意味します。
       
       Image Added
       
       
13. Rインスタンスへのリモート接続：接続を試行するRserveがリモート端末にインストールされている場合は、以下の手順に従います。
    1. 「External Connection（外部接続）」ボタンへ切り替えます。以下のフィールドが表示されます。
       
       Image Added
       
       
    2. Rserveをホストしている端末のIPを提供します。IPアドレス（例：127.0.0.1）、または端末のホスト名（例；Localhost）を入力します。注意：IPアドレス、またはホスト名の前に「http://」を含めてはいけません。これは、接続の確立を妨げることになります。
    3. Rに接続するポート番号を入力します。これは、Rserve起動時に使用したポート番号と同一のものです。
    4. 注意：接続を試行する端末が、パスワードやユーザーログイン情報を要求しないことを確認してください。現在、ユーザー名やパスワードを使用した接続は、RスクリプトTransformation Step（変換ステップ）ではサポートしていません。
    5. 「Connect to Rserve（Rserveへ接続）」ボタンをクリックします。手順12へ進みます。
14. 接続の確立に成功すると、詳細な設定画面が表示されます。
    
    Image Added
    
    
15. これらを使用し、以下の2つの方法のいずれかを使用して、Rスクリプトを組み込みます。
    1. 指定されたパネルにRスクリプトをドラッグします。

    2. または、「Load from Path（パスから読み込み）」トグルを有効にして、ファイルパスを提供します。完全パスを入力してください。例：
       Windowsの場合：C:\Users\admin\Desktop\append.r、Linuxの場合：/root/append.r
       
       

       Note
       ファイル形式が適切であることを確認してください。例：「.r」拡張子が必要です。

       
       
       

16. スクリプトの設定詳細を提供します。注意：こちらで提供する詳細は、Rスクリプトのコンテンツと、実行するようにデザインされた機能に特異のものです。そのため、スクリプト内に機能が含まれているものと見なされます。
17. データを含めるために、以下のいずれかの方法を選択します。：追加、または置き換え
    1. 追加：スクリプトが、入力データとともに新規フィールドの生成を返す場合は、こちらの方法を選択します。データに追加される新規フィールド数を指定します。
    2. 置き換え：スクリプトが、デザインされた結果を返す場合は、こちらの方法を選択します（これは新規フィールドのみの場合もあれば、新規フィールドと入力フィールドの組み合わせの場合もあり、スクリプト作成者が、スクリプトがどのような結果を生成するようにデザインをしているかに応じて異なります）。Rスクリプトが生成するフィールドの合計数を入力します。
18. Step（ステップ）の実行を成功させるためには、正確なフィールド数を提供しなくてはいけません。不正確な値を入力した場合は、Step（ステップ）の実行時に以下のエラーが表示されます。
    
    Image Added
    
    
19. スクリプト内で明示されている「入力変数名」を入力します。これは、データがどこから読み込まれるかを指定します。
20. 「出力変数名」を入力します。これは、結果が保存されるスクリプト内の場所を指定します。（システムは、この変数に保存された値を、スクリプトが生成する結果として返します。このパラメーターは、データフレーム変数でなくてはいけません）
21. いずれの変数名に不正確な名前が提供された場合は、Step（ステップ）の実行時に以下のエラーが表示されます。例：
    
    Image Added
    
    
22. 「Apply（適用）」をクリックします。
23. Step（ステップ）の実行に成功すると、データプレビューパネルに結果が表示されます。以下の例は、既存のデータに結果フィールドが追加された結果を示しています。（注意：追加オプションの場合、入力データからの結果フィールドは、元の名前とデータ型を持ちます。そして、新規追加されたフィールドは、「newField0」、「newField1」....と名付けられ、データ型はデフォルトでテキストになります。）
    
    Image Added
    
    同様に、こちらはスクリプトで指定された結果によりデータが置き換えられた例を示しています。（注意：このオプションで返されるすべてのフィールドは、「field0」「field1」.....と名付けられ、データ型はテキストになります。）
    
    Image Added
    
    
24. こちらのStep（ステップ）の実行が失敗する場合、原因は複数考えられます。いくつかの原因が生成するエラーの例は、こちらをクリックして参照してください。
25. Step（ステップ）の実行に成功したら、さらなる変換を実行したり、結果をデータベースへ保存することができます。

Note
こちらのStep（ステップ）が表示されない場合は、PFAのプラグインがインストールされているかを確認してください）

Image Removed
Connection（接続）ポイントを使用して、最後のStep（ステップ）をPFA Step（ステップ）へ接続します。
Image Removed

26. PFA Step（ステップ）をクリックすると、Transformation Flow（変換フロー）パネルに設定が表示されます。
27. YAML、またはJSONオプションを選択して、ファイルの拡張子を指定します。
28. モデルを含むPFAファイルをアップロードします。ファイルはドラッグ&ドロップ、またはファイルパスの指定によりアップロードすることができます。
デフォルトのドラッグ&ドロップオプションを使用している場合は、指定されたエリアへ対象のファイルをドラッグします（または、エリアをクリックして、対象のファイルを選択します）
注意：不適切なファイルタイプがドラッグされた場合、以下のようなエラーメッセージが表示されます。
Image Removed
パスからPFAファイルを読み込む場合は、「Load from Path（パスからの読み込み）」トグルを有効にし、ファイルパス、またはURLを入力します。


Note
サーバファイル、またはウェブサイトのURLの完全パスを入力します。URLの場合は、「http:」、または「https:」で始まることを確認してください。

Image Removed

次に、「Load File（ファイルの読み込み）」ボタンをクリックします。Step（ステップ）は、ファイルの解析を開始しますが、ファイルパスが不正確な場合は、以下のエラーメッセージが表示されます。
Image Removed
ファイルのアップロードが完了したら、モデルの入力を設定するさらなるフィールドが表示されます。（注意：これらのフィールドの表示には時間を要する場合があります）
Image Removed
注意：これらのフィールドは、変数の名前でラベルされている場合がありますが、PFAファイル内で名前が指定されていない場合は、変数のタイプが表示されます。例：
Image Removed

29. モデルのデータを、以前のStep（ステップ）から取得されるデータとマッピングします。データ型が一致することを確認してください。（ユーザーはPFAファイル内のモデルを熟知しているため、正確なマッピングができると見なされます）
30. 「Save（保存）」ボタンをクリックします。
    Image Removed
    データプレビューパネルのカラム（列）に、データサイエンスモデルにより生成された結果が表示されます。注意：この出力カラム（列）に表示される名前は、PFAファイル内で指定されたものに準じます。出力の名前が指定されていない場合、カラム（列）はデフォルトで「PFA出力」とラベルされます。
    Image Removed