ブロックリファレンス

BLOCKS Reference

Box

Box から変数へロード

概要

このブロックは、Box 上のファイルを読み取り、その内容を変数に格納します。

このブロックを利用することで、Box 上のファイルを使ってモデルジェネレーターの予測をしたり、Box 上のファイルから BigQuery へデータを投入することなどが可能となります。

このブロックは、フローデザイナーのメモリの使用量の制限により、大規模なファイルの扱いは困難です。Box 上の大規模なファイルを扱う場合は、「Box から GCS へファイルをコピー」ブロックの利用をおすすめします。

Box 上のファイルは、そのまま読み込むこともできますが、[ファイル形式] プロパティを適切に設定することで、他ブロックの利用に即した形式へ変換して読み込むこともできます。

ファイル形式 説明
(none) ファイル内容をそのまま変数に格納します。
バイナリ (Base64)

ファイル内容を Base64 でエンコードして、変数に格納します。

[モデルジェネレーター予測(オンライン)] ブロックを使って画像を分類する場合は、このファイル形式を選択してください。

JSON ファイル内容を JSON 形式で解析し、オブジェクトに変換して、変数に格納します。
CSV

ファイル内容を CSV 形式で解析し、オブジェクトに変換して、変数に格納します。CSV ファイルの各フィールドは、オブジェクト変換時にすべて文字列として扱われます。

CSV の形式は、以下のようなフィールド名を持つヘッダー行があることを前提としています。フィールド名を持つヘッダー行とは、他の行と同じ個数のフィールドを持ち、フィールドの名称が列挙されている行のことです。

field_name_1,field_name_2,field_name_3
aaa,bbb,ccc
xxx,yyy,zzz

この形式の CSV を読み込むと、以下のようなオブジェクトが変数に格納されます。

[
  {
    "field_name_1": "aaa",
    "field_name_2": "bbb",
    "field_name_3": "ccc"
  },
  {
    "field_name_1": "xxx",
    "field_name_2": "yyy",
    "field_name_3": "zzz"
  }
]

[モデルジェネレーター予測(オンライン)] ブロックを使って数値分類や数値回帰を行う場合は、以下のようにキー用のフィールドの名称を key とし、予測因子のフィールドにそれぞれの項目名を指定したヘッダー行を用意してください。

key,sepal_legth,sepal_width,petal_length,petal_width
1,5.9,3.0,4.2,1.5
2,6.9,3.1,5.4,2.1
3,5.1,3.3,1.7,0.5

数値はすべて文字列に変換されますが、[モデルジェネレーター予測(オンライン)] ブロックでは、数値を文字列としたデータも受け付けるため、問題ありません。

プロパティ

プロパティ名 説明
ブロック名 ブロックの名前を指定します。ブロックに表示されます。
Box サービスアカウント

Box アカウントを選択します。

Box サービスアカウントは、あらかじめフローデザイナーの設定Box サービスアカウントで設定を済ませておく必要があります。

ユーザーID

Box サービスアカウントのユーザー ID を指定します。

Box サービスアカウント(Box アプリ)のアプリケーションアクセスがアプリケーションの場合は、何も入力しないでください。

Box サービスアカウントのユーザー ID は、Box 開発者コンソール から Box アプリを選択し、General のアプリ情報から確認できます。

Box 開発者コンソールのユーザー ID

※画像をクリックすると画像が拡大して表示されます。

読み込みファイルパス

読み込みたいファイルの Box 上の位置を以下の形式で指定します。

  • /ファイル
  • /フォルダー/ファイル

先頭の / は、Box の「すべてのファイル」ページを示します。フォルダー名とファイル名の間にある / は、フォルダー名とファイル名を切り分けるための区切り文字です。

/ファイル は、Box の「すべてのファイル」ページに表示されているファイルを指定する場合の形式です。「すべてのファイル」ページに表示されているファイル sample.png を指定する場合は、/sample.png とします。

/フォルダー/ファイル は、フォルダー内にあるファイルを指定する場合の形式です。「すべてのファイル」ページに表示されている BLOCKS というフォルダーの中にあるファイル sample.png を指定する場合は、/BLOCKS/sample.png とします。

フォルダーが入れ子になっている場合は、/フォルダー 1/フォルダー 2/ファイル のような形式で指定します。
フォルダー A の中にフォルダー B があり、そのフォルダー B の中にあるファイル sample.png を指定する場合は、/A/B/sample.png とします。

変数展開の指定が可能][% 形式の文字列書式の指定が可能]
ファイルデータを格納する変数 読み込んだファイルの内容を格納する変数を指定します。
ファイル形式

読み込むファイルの形式を [(none) / バイナリ (Base64) / JSON / CSV] から選択します。

ブロックメモ ブロックに対するコメントを指定します。
CSV の区切り文字

[ファイル形式] プロパティが [CSV] の場合、CSV ファイルの区切り文字を [カンマ (,) / タブ / パイプ (|) / その他] から選択します。

[その他] を選択した場合は、[その他] の横の入力フィールドに、区切り文字を指定してください。

読み飛ばし行数 [ファイル形式] プロパティが [CSV] の場合、先頭から何行を読み飛ばすかの行数を指定します。
クオート記号を指定 [ファイル形式] プロパティが [CSV] の場合、フィールドを囲むためのクオート記号を指定します。

この情報は役に立ちましたか?