分析Code WorkbooksWorkbooks入力と出力

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

入力と出力

入力のデータ型と変換

Code Workbook では、トランスフォームが受け取る各入力のデータ型を指定できます。入力のデータ型は、トランスフォーム名の下にあるドロップダウンメニューを選択して設定できます。

入力のデータ型を更新

指定した入力のデータ型が実際に受け取る入力のデータ型と一致しない場合、Code Workbook が必要な変換を行います。

たとえば、transform_A の出力が pandas データフレームで、その派生トランスフォームである transform_B の入力を手動で Spark データフレームに設定した場合、Code Workbook は pandas データフレームを指定された Spark データフレームに変換します。transform_C の出力が pandas データフレームで、その派生トランスフォームである transform_D が入力として R data.frame を指定した場合、Code Workbook はまず pandas データフレームを Spark データフレームに戻してから、R data.frame に変換します。

次のフローチャートは、Code Workbook が入力のデータ型間の変換をどのように処理するかを示しています。

Code Workbook の変換フローチャート

入力と出力の制限

出力タイプ

Code Workbook のトランスフォームは、任意の数の入力を持つことができ、それぞれに異なる入力のデータ型を設定できます。ただし、トランスフォームの出力は1個に限られます。現在、複数の出力はサポートされていません。

Code Workbook のトランスフォームで使用できる出力タイプは、言語に応じて次の種類に限られます。

言語許可される出力タイプ
PythonSpark データフレーム、Pandas データフレーム、FoundryObject、None
RR data.frame、FoundryObject、NULL
SQLSpark データフレーム

トランスフォームが上記以外のデータ型を返した場合、Code Workbook はサポートされていないデータ型のエラーを返します。

None および NULL の出力タイプ

Code Workbook では、戻り値が None/NULL のトランスフォームを実行できますが、下流のトランスフォームは None/NULL を入力として受け付けません。

Python の入力のデータ型

デフォルトでは、Python トランスフォームは入力を Spark データフレームとして受け取ります。トランスフォーム名の下にあるドロップダウンメニューを選択して入力のデータ型を設定すると、Code Workbook が上流の出力を指定した入力のデータ型に変換します。

入力のデータ型を更新

Python トランスフォームでは、次の入力のデータ型がサポートされています。

入力のデータ型説明
Spark データフレーム(デフォルト)pyspark.sql.dataframe.DataFrame クラスの PySpark データフレーム
Pandas データフレームpandas.core.frame.DataFrame クラスの Pandas データフレーム
Python トランスフォーム入力(「データセットとして保存」した入力でのみ利用可能)入力内のファイルに直接アクセスできる FileSystem オブジェクトです。非構造化ファイルにアクセスするのドキュメントを参照してください。
オブジェクトモデリングワークフローを実行できる Foundry モデルオブジェクトです。モデルのドキュメントを参照してください。

R の入力のデータ型

デフォルトでは、R トランスフォームは入力を R data.frame として受け取ります。トランスフォーム名の下にあるドロップダウンメニューを選択して入力のデータ型を設定すると、Code Workbook が上流の出力を指定した入力のデータ型に変換します。

入力のデータ型を更新

R トランスフォームでは、次の入力のデータ型がサポートされています。

入力のデータ型説明
Spark データフレームSparkDataFrame クラスの SparkR データフレーム
R data.frame(デフォルト)data.frame クラスの R データフレーム
R トランスフォーム入力(「データセットとして保存」した入力でのみ利用可能)入力内のファイルに直接アクセスできる FileSystem オブジェクトです。非構造化ファイルにアクセスするのドキュメントを参照してください。
オブジェクトモデリングワークフローを実行できる Foundry モデルオブジェクトです。モデルのドキュメントを参照してください。

SQL の入力と出力のデータ型

SQL トランスフォームでサポートされている入力と出力のデータ型は、Spark データフレームのみです。データフレームは SQL 内でテーブルとして読み取ることができます。