from_hb_results() メソッド

リザルトテーブルを HCL データフレームにインポートします。

メモ

hcl.from_hb_results() メソッドを使用するには、HCL スクリプト エディターの［変数］ウィンドウでパスワード変数 v_hb_token を作成し、HighBond API トークンを変数値として割り当てる必要もあります。詳細については、［変数］ウィンドウを使用して HCL 変数を定義するを参照してください。

構文

hcl.from_hb_results(table_id = リザルト テーブル ID 番号)

パラメーター

名前 説明
table_id = リザルト テーブル ID 番号 リザルト テーブルの数値 ID。

戻り値

HCL データフレーム。

例

リザルトテーブルを HCL データフレームにインポートする

ID 587293 の結果テーブルを、新しく作成した HCL データフレームに customer_summary という名前でインポートします。

customer_summary = hcl.from_hb_results(table_id = "587293")

備考

データ型のマッピング

リザルトテーブルを HCL データフレームにインポートする場合、テーブルのフィールドデータ型はデータフレームの列データ型に自動的にマッピングされます。

リザルトテーブルのデータの不整合は、データ型のマッピングや個々の値の変換に影響します。

  • リザルトテーブルの数値フィールドに 1 つでも文字値が含まれていると、HCL データフレームの対応する列は object データ型を使用し、列内のすべての値はテキスト文字列として定義されます。

  • リザルトテーブルの論理フィールドにブール値以外の値（T/F または Y/N 以外の値）が含まれている場合、それらの値は HCL データフレームでは None（なし）になります。

  • リザルトテーブルの日付時刻フィールドに空の値が含まれている場合、それらの値は HCL データフレームでは NaT（Not-a-Time）になります。

リザルトテーブルのフィールドのデータ型 HCL データフレームの列のデータ型
文字 オブジェクト
文字 カテゴリ
数値 int64
数値 float64
日付時刻 datetime64[ns]
数値 timedelta64[ns]
論理 bool
データ型を特定できません オブジェクト