Quick BI では、ローカルの Excel ファイルと CSV ファイルをデータベースにアップロードできます。これらのファイルをビジネス分析ニーズのデータソースとして使用できます。このトピックでは、ファイルをアップロードするためのエントリポイントについて説明し、ファイルデータソースを作成および変更する方法について説明します。
シナリオ
ローカルファイルからデータソースを作成し、オンラインデータソースと一緒に分析できます。
制限
ファイルの種類 | 制限 |
Excel |
|
CSV |
|
注意事項
ファイルをアップロードする際は、次の点にご注意ください:
サポートされているフィールドタイプは、テキスト、数値、日付です。フィールドを設定するときに、これらのタイプを選択するか、データの内容に基づいてシステムに自動的に識別させることができます。フィールドタイプを変更することもできます。
CSV ファイルをアップロードする場合は、ファイルを UTF-8 フォーマットに変換してください。
Quick BI は、UTF-8 フォーマットの CSV ファイルのエンコーディングを正確に識別します。ただし、GBK および GB2312 フォーマットの CSV ファイルのエンコーディングは自動的に識別されない場合があり、文字化けが発生する可能性があります。
ファイルのアップロードには Google Chrome を使用してください。
アップロードされたファイルでは、列のデータの型は最初の 100 行の値によって決まります:
最初の 100 行に数値のみが含まれている場合、システムはその列を数値として識別します。
最初の 100 行のいずれかに文字列が含まれている場合、システムはその列を文字列として識別します。
数値フィールドは文字列データと互換性がありません。文字列フィールドは数値データと互換性があります。
準備
エントリポイント
Quick BI コンソールにログオンし、次のいずれかの方法でローカルファイルをアップロードします。
データソースページからローカルファイルをアップロードする
ターゲットデータソースに対する読み取りおよび書き込み権限が必要です。データソースはファイルのアップロードもサポートしている必要があります。どのデータソースがファイルのアップロードをサポートしているかについての詳細については、「データソース機能項目一覧」をご参照ください。

データセット編集ページからローカルファイルをアップロードする

ファイルをアップロードする
[ファイルアップロード] ページで、ローカルファイルをアップロードして設定し、データソースとして使用できます。サポートされているファイルタイプには Excel と CSV があります。このトピックでは、販売データ例 .xlsx Excel ファイルを例として使用します。
Excel ファイルをアップロードする場合、最大 5 つのシートをアップロードできます。6 つ以上のシートをアップロードするには、コンテンツを複数の Excel ファイルに分割します。
CSV ファイルをアップロードする場合は、UTF-8 形式を使用することをお勧めします。
[ファイルアップロード] ページで、ファイルをアップロードエリアにクリックまたはドラッグします。アップロードが完了すると、[データプレビュー] ページが表示されます。

[データプレビュー] ページでは、次の情報をプレビューして調整できます。

表示内容
構成
操作
エリア ①
アップロードされたファイルのシートとタイトル
シートの切り替え
タブをクリックしてシートを切り替え、データをプレビューします。タブを切り替えると、エリア ④ のデータが変更されます。
シート名の変更
シート名をダブルクリックして、ビジネスニーズに基づいて名前を変更します。デフォルトでは、Quick BI はローカルファイルのシート名を使用します。
説明シート名には、特殊文字や先頭または末尾のスペースを含めることはできません。
シートの選択ステータスの変更
シート名の横にある
アイコンをクリックして、選択ステータスを変更します。デフォルトでは、すべてのシートが選択されています。シートのチェックボックスをオフにすると、そのシートはアップロードされません。説明ファイルをアップロードするには、少なくとも 1 つのシートを選択する必要があります。
シートのショートカット
タブバーの右側にある
アイコンをクリックし、ドロップダウンリストからショートカットを選択します。
現在のシートのみを選択: 現在のシートのみが選択されます。ファイルがアップロードされると、現在のシートのデータのみが含まれます。
すべてのシートを選択: タブバーのすべてのシートが選択されます。ファイルがアップロードされると、すべてのシートのデータが含まれます。
現在のシートを除外: 現在のシートの選択が解除されます。ファイルがアップロードされると、現在のシートのデータは含まれません。
エリア ②
ファイル名
表示名
Quick BI でのアップロードされたファイルの表示名。ファイルをアップロードすると、システムは自動的にファイル名を表示名として使用します。必要に応じて名前を変更できます。
説明表示名には、特殊文字や先頭または末尾のスペースを含めることはできません。
物理テーブル名
ファイルがアップロードされた後、データベースに自動的に作成されるテーブルの名前。必要に応じて物理テーブル名を変更できます。
説明物理テーブル名には、文字、数字、アンダースコア (_) のみを含めることができます。名前の長さは 150 文字以内である必要があります。
エリア ③
ヘッダー行
ヘッダー行
ここで現在のシートのヘッダー行を変更できます。
説明数値は 0 より大きい整数でなければなりません。
ヘッダー行に空のフィールドが含まれていないことを確認してください。そうでない場合、エラーが発生します。
エリア ④
データプレビュー
データプレビュー
[データプレビュー] タブでは、データをプレビューし、次の操作を実行できます。
フィールド名の変更: フィールド名テキストボックスをクリックして、フィールド名を変更します。
フィールドタイプの変更: フィールドタイプアイコンをクリックし、ドロップダウンリストからフィールドタイプを選択します。サポートされているタイプは、テキスト、数値、日付です。

フィールド詳細
[フィールド詳細] タブでは、ファイルフィールド名、データベースフィールド名、およびフィールドタイプを設定できます。
ファイルがアップロードされると、データベーステーブルとして保存されます。データベースフィールド名とフィールドタイプは、生成されたデータベーステーブルのフィールド名とタイプとして使用されます。ファイル列名は、データベーステーブルのフィールドコメントになります。

ページ下部の [確認してアップロード] をクリックします。各シートのアップロードの進捗状況を示すダイアログボックスが表示されます。
アップロードに失敗した場合は、エラーダイアログボックスの [戻る] (①) をクリックして [データプレビュー] ステップに戻り、フィールドタイプやシート名などの詳細を調整できます。また、[再アップロード] (②) をクリックして [ファイルアップロード] ステップに戻り、修正したファイルをアップロードすることもできます。
ファイルがアップロードされた後、[データソースリストに戻る] をクリックして、アップロードされたファイルデータソースを表示します。

アップロード済みファイルの変更
ビジネスデータファイルをアップロードした後、ビジネスの変更により更新が必要になる場合があります。データを追加したり、ファイルを置き換えたり、古いファイルを削除したりして、継続的な分析をサポートできます。
ターゲットファイルの右側にある
アイコンをクリックして、[ファイルアップロードの変更] ページに移動します。次の操作を実行できます。
構成 | 操作 | |
表示名 | Quick BI でのファイルの表示名。この名前は変更できます。 説明 表示名には、特殊文字や先頭または末尾のスペースを含めることはできません。 | |
データプレビュー | データの表示 | [追加履歴] パネルで、ファイルを切り替えてデータを表示します。 |
フィールドの変更 |
| |
フィールド詳細 | フィールドの変更 |
|
フィールドの追加 | テーブルの右上隅にある [フィールドの追加] をクリックします。[フィールドの追加] ダイアログボックスで、新しいフィールドの情報を入力し、[OK] をクリックします。 説明 [全体データ] を表示している場合にのみフィールドを追加できます。
| |
追加履歴 | 追加履歴の表示 | [追加履歴] パネルには、追加されたファイルが一覧表示されます。ファイルカードをクリックして、追加されたコンテンツを表示します。 |
ファイルの追加 | ビジネスの成長により新しいビジネスデータファイルが生成された場合、新しいファイルを既存のファイルデータソースに対応するテーブルに追加できます。詳細については、「ファイルの追加」をご参照ください。 | |
ファイルの置き換え | ビジネスの変更により新しいビジネスデータが古いビジネスデータを置き換える必要がある場合、古いファイルを置き換えることができます。詳細については、「ファイルの置き換え」をご参照ください。 | |
ファイルの削除 | ビジネスデータファイルにダーティデータが含まれている場合、テーブルに対応するアップロード済みファイルのリストからファイルを削除できます。詳細については、「ファイルの削除」をご参照ください。 | |
ファイルの追加
新しいビジネスデータが生成された場合、それを既存のファイルに追加して、データの最新性と完全性を確保できます。次の手順に従ってください。
[ワークベンチ] にログオンし、[データソース] ページに移動します。[アップロード済みファイル] リストで、ターゲットファイルを見つけ、その名前 (③) または [アクション] 列の
アイコン (④) をクリックします。
[ファイルアップロードの変更] ページで、右側の [追加] をクリックします。

[ファイルの追加] パネルで、追加したいファイルをクリックまたはアップロードエリアにドラッグします。

[データプレビュー] ページで、元のファイルに追加したいシートタブ (①) に切り替えます。必要に応じて [ヘッダー行] (②) と [フィールドタイプ] (③) を変更できます。その後、[次へ] (④) をクリックします。

[フィールドマッチング] ステップで、追加するファイルと元のファイルのフィールドを照合します。システムはデフォルトで同じ名前のフィールドを照合します。照合関係は手動で変更できます。名前が異なるフィールドについては、[照合するフィールド] エリアから [フィールドマッチング] エリアに手動でドラッグすることもできます。
説明元のファイルと追加するファイルのフィールドタイプが一致していることを確認してください。そうでない場合、エラーが発生します。照合ルールは次のとおりです:
元のフィールドがテキストの場合: 任意のフィールドタイプと照合できます。
元のフィールドが数値の場合: 数値タイプとのみ照合できます。
元のフィールドが日付の場合: 日付タイプとのみ照合できます。
追加するファイルに元のファイルよりも多くのフィールドがある場合、[フィールドの追加] をクリックして、元のファイルに対応するフィールドを作成して照合できます。余分なフィールドが不要な場合は、次のステップに進むことができます。

追加するファイルに元のファイルよりも少ないフィールドがある場合、元のファイルの余分なフィールドは照合されないままにすることができます。その後、次のステップに進むことができます。

追加するファイルに重複したフィールドが含まれている場合、システムは同じ名前のフィールドを順番に照合しようとします。この場合、[フィールドマッチング] ステップで照合関係を手動で調整する必要があります。元のテーブルの各フィールドが、追加するファイルの対応する 1 つのフィールドとのみ照合されるようにしてください。重複したフィールドについては、ビジネスニーズに基づいて照合するものを 1 つ選択します。
[確認してアップロード] をクリックします。アップロードが成功すると、追加履歴パネルで追加されたファイルを表示できます。

(オプション) 追加したファイルを置き換えるには、[追加履歴] パネルに移動し、置き換えたいファイルの横にある
アイコンをクリックします。これにより [ファイルの置き換え] インターフェイスが開き、関連する操作を実行できます。
ファイルの置き換え
元のファイルの一部のデータを置き換える必要があるが、他のデータはまだ有効な場合、既存のデータソースのデータを置き換えてデータの正確性を維持できます。次の手順に従ってください。
[ファイルアップロードの変更] ページで、[追加履歴] パネルに移動します。置き換えるファイルを選択し、ファイルカードの
アイコンをクリックするか、データテーブルの右上隅にある [データの置き換え] をクリックします。
[ファイルの置き換え] ページで、新しいファイルをクリックまたはアップロードエリアにドラッグします。
説明単一シートの置き換えのみがサポートされています。アップロードするファイルに複数のシートがある場合は、アップロードする前にプレビューページで正しいシートを選択してください。
[データプレビュー] ページで、元のファイルを置き換えるために使用するシートタブ (①) に切り替えます。必要に応じて [ヘッダー行] (②) と [フィールドタイプ] (③) を変更できます。その後、[次へ] (④) をクリックします。

[フィールドマッチング] ステップで、置き換えファイルと元のファイルのフィールドを照合します。システムはデフォルトで同じ名前のフィールドを照合します。照合関係は手動で変更できます。名前が異なるフィールドについては、[照合するフィールド] エリアから [フィールドマッチング] エリアに手動でドラッグすることもできます。
説明元のファイルと置き換えファイルのフィールドタイプが一致していることを確認してください。そうでない場合、エラーが発生します。照合ルールは次のとおりです:
元のフィールドがテキストの場合: 任意のフィールドタイプと照合できます。
元のフィールドが数値の場合: 数値タイプとのみ照合できます。
元のフィールドが日付の場合: 日付タイプとのみ照合できます。
置き換えファイルに元のファイルよりも多くのフィールドがある場合、[フィールドの追加] をクリックして、元のファイルに対応するフィールドを作成して照合できます。余分なフィールドが不要な場合は、次のステップに進むことができます。

置き換えファイルに元のファイルよりも少ないフィールドがある場合、元のファイルの余分なフィールドは照合されないままにすることができます。置き換え後、余分なフィールドはデータに保持されます。データの [フィールド詳細] で表示できます。

置き換えファイルに重複したフィールドが含まれている場合、システムは同じ名前のフィールドを順番に照合しようとします。この場合、[フィールドマッチング] ステップで照合関係を手動で調整する必要があります。元のテーブルの各フィールドが、置き換えファイルの対応する 1 つのフィールドとのみ照合されるようにしてください。重複したフィールドについては、ビジネスニーズに基づいて照合するものを 1 つ選択します。
[確認してアップロード] をクリックします。アップロードが成功すると、追加履歴パネルで置き換えられたファイルを表示できます。

ファイルの削除
ビジネスデータファイルが不要になった場合、またはファイルにダーティデータが含まれている場合は、[ファイルアップロードの変更] ページの [追加履歴] パネルからファイルを選択して削除できます。
サンプルローカルファイル
練習用に次の CSV ファイルをダウンロードできます: 販売データ例.csv。
練習用に次の Excel ファイルをダウンロードできます: 販売データ例 .xlsx。
次の表に、販売データの構造を示します。
フィールド名 | フィールドタイプ | フィールドの説明 |
order_id | varchar | 注文 ID |
report_date | datetime | 注文日 |
customer_name | varchar | 顧客名 |
order_level | varchar | 注文レベル |
order_number | double | 注文数量 |
order_amt | double | 注文金額です。 |
back_point | double | 割引 |
shipping_type | varchar | 配送方法 |
profit_amt | double | 利益額 |
price | double | 単価です。 |
shipping_cost | double | 送料 |
area | varchar | 地域です。 |
province | varchar | 都道府県 |
city | varchar | 市 |
product_type | varchar | 製品タイプ |
product_sub_type | varchar | 製品サブタイプ |
product_name | varchar | 製品名です。 |
product_box | varchar | 製品パッケージ |
shipping_date | datetime | 出荷日です。 |
FAQ
1. アップロードした CSV ファイルの内容が文字化けした場合はどうすればよいですか?
Quick BI は、UTF-8 フォーマットの CSV ファイルを正確にデコードします。ほとんどの場合、Quick BI は GBK または GB2312 フォーマットの CSV ファイルもデコードできます。ただし、デコードが失敗する場合もあります。これらのファイルは UTF-8 フォーマットに変換する必要があります。
メモ帳 を使用して CSV ファイルを開きます。
[名前を付けて保存] を選択します。
[エンコーディング] のドロップダウン矢印をクリックします。
[エンコーディング] リストから、[UTF-8] を選択します。

2. ファイルを追加するときに「フィールドタイプが一致しません」というエラーが発生した場合はどうすればよいですか?
理由 1: ソーステーブルと追加されたテーブルのフィールドタイプが一致していません。どちらかのテーブルのデータの型を手動で変更するか、フィールドを再照合する必要があります。
理由 2: 追加された Excel ファイルの列に空のセルのみが含まれている場合、Quick BI はそのフィールドをテキストとして識別します。元のテーブルの対応するフィールドが数値の場合、「フィールドタイプが一致しません」というエラーが発生します。この問題を解決するには、追加された Excel ファイルの空の列のいずれかのセルに数値を追加します。その後、ファイルを正常にアップロードできます。
3. 「Excel ファイルの解析に失敗しました」というエラーでファイルのアップロードが失敗した場合、またはアップロード後にデータが不正確な場合はどうすればよいですか?
理由: アップロードされたファイルの形式または内容が要件を満たしていません。次の項目を確認してください:
解決策:
チェック 1: ファイルタイプが CSV または Excel であることを確認します。Excel ファイルの場合は、フォーマットが .xls または .xlsx であることを確認します。また、ファイルが「注意」で説明されている要件を満たしていることを確認します。
チェック 2: ファイル形式とサイズが「制限」で説明されている基準を満たしていることを確認します。
4. アップロードボタンが見つからない、またはグレー表示されているのはなぜですか?
理由 1: 必要な権限がありません。ファイルをアップロードしてファイルデータソースを作成するには、ワークスペースの開発者権限以上の開発者である必要があります。または、データソースを使用または編集する権限が付与されている必要があります。
理由 2: ターゲットデータソースに対する読み取りおよび書き込み権限がありません。Quick BI データソースに使用されるデータベースアカウントに、データベースに対する読み取りおよび書き込み権限があることを確認してください。これらの権限がないと、ファイルをアップロードできません。データベース管理者に連絡して、必要な権限を付与してもらってください。
5. ファイルを追加したり、新しいフィールドを追加したりした後、データセットに新しいフィールドが表示されないのはなぜですか?
理由: 元のテーブルにそのフィールドが含まれていませんでした。新しいフィールドを追加した後、デフォルトではデータセットで選択されていません。データセット編集ページで、モデル設定インターフェイスに移動し、フィールドのチェックボックスを手動で選択して表示します。
6. アップロードするファイルを選択するときに CSV ファイルが表示されないのはなぜですか?
理由: Windows 環境では、アップロードボタンをクリックすると、ファイル選択ダイアログボックスにはデフォルトで .xlsx ファイルのみが表示されます。CSV ファイルを見つけるには、ファイルタイプのオプションからすべてのファイルを選択する必要があります。
