すべてのプロダクト
Search
ドキュメントセンター

Quick BI:ファイルデータソースの追加

最終更新日:Sep 19, 2025

Quick BI では、ローカルの Excel ファイルと CSV ファイルをデータベースにアップロードできます。これらのファイルをビジネス分析ニーズのデータソースとして使用できます。このトピックでは、ファイルをアップロードするためのエントリポイントについて説明し、ファイルデータソースを作成および変更する方法について説明します。

シナリオ

ローカルファイルからデータソースを作成し、オンラインデータソースと一緒に分析できます。

制限

ファイルの種類

制限

Excel

  • デフォルトでは、システムはアップロードされたファイルの最初の行をヘッダー行として識別し、2 行目からデータの読み取りを開始します。必要に応じて、[データプレビュー] ページでヘッダー行を調整することもできます。

  • ヘッダー行に空のセルを含めることはできません。[データプレビュー] ページでヘッダー行の数を設定するか、ファイルを変更して再度アップロードできます。

  • 最大 5 つのシートを解析してアップロードできます。6 つ以上のシートをアップロードするには、コンテンツを複数の Excel ファイルに分割します。

  • 1 つのシートに 100 を超える列や結合されたセルを含めることはできません。

  • 推奨されるファイルサイズは 50 MB 以下です。たとえば、ファイルに 98 列と 100 万行があり、サイズが 80 MB の場合、複数のファイルに分割し、行を追加してアップロードする必要があります。

  • 互換性と読みやすさを確保するために、ファイル名に特殊文字を使用しないでください。

  • VLOOKUP や SUMIFS など、アップロードされた Excel ファイル内の Excel 関数によって計算されたコンテンツは避けてください。

  • ワークスペースには最大 100 個のデータソースを含めることができます。

CSV

  • ファイルには最大 100 列を含めることができます。

  • 推奨されるファイルサイズは 50 MB 以下です。たとえば、ファイルに 98 列と 100 万行があり、サイズが 80 MB の場合、複数のファイルに分割し、行を追加してアップロードする必要があります。

注意事項

ファイルをアップロードする際は、次の点にご注意ください:

  • サポートされているフィールドタイプは、テキスト、数値、日付です。フィールドを設定するときに、これらのタイプを選択するか、データの内容に基づいてシステムに自動的に識別させることができます。フィールドタイプを変更することもできます。

  • CSV ファイルをアップロードする場合は、ファイルを UTF-8 フォーマットに変換してください。

    Quick BI は、UTF-8 フォーマットの CSV ファイルのエンコーディングを正確に識別します。ただし、GBK および GB2312 フォーマットの CSV ファイルのエンコーディングは自動的に識別されない場合があり、文字化けが発生する可能性があります。

  • ファイルのアップロードには Google Chrome を使用してください。

  • アップロードされたファイルでは、列のデータの型は最初の 100 行の値によって決まります:

    • 最初の 100 行に数値のみが含まれている場合、システムはその列を数値として識別します。

    • 最初の 100 行のいずれかに文字列が含まれている場合、システムはその列を文字列として識別します。

    数値フィールドは文字列データと互換性がありません。文字列フィールドは数値データと互換性があります。

準備

  1. サポートされているファイルタイプを確認する

    • サポートされているファイルタイプは CSV と Excel です。サポートされている Excel のフォーマットは .xls と .xlsx です。

    • 詳細については、「注意事項」をご参照ください。

  2. ファイル形式とサイズが「制限」の要件を満たしていることを確認してください。

エントリポイント

Quick BI コンソールにログオンし、次のいずれかの方法でローカルファイルをアップロードします。

  • データソースページからローカルファイルをアップロードする

    ターゲットデータソースに対する読み取りおよび書き込み権限が必要です。データソースはファイルのアップロードもサポートしている必要があります。どのデータソースがファイルのアップロードをサポートしているかについての詳細については、「データソース機能項目一覧」をご参照ください。image

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

ファイルをアップロードする

[ファイルアップロード] ページで、ローカルファイルをアップロードして設定し、データソースとして使用できます。サポートされているファイルタイプには Excel と CSV があります。このトピックでは、販売データ例 .xlsx Excel ファイルを例として使用します。

説明
  • Excel ファイルをアップロードする場合、最大 5 つのシートをアップロードできます。6 つ以上のシートをアップロードするには、コンテンツを複数の Excel ファイルに分割します。

  • CSV ファイルをアップロードする場合は、UTF-8 形式を使用することをお勧めします。

  1. [ファイルアップロード] ページで、ファイルをアップロードエリアにクリックまたはドラッグします。アップロードが完了すると、[データプレビュー] ページが表示されます。111

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

    表示内容

    構成

    操作

    エリア ①

    アップロードされたファイルのシートとタイトル

    シートの切り替え

    タブをクリックしてシートを切り替え、データをプレビューします。タブを切り替えると、エリア のデータが変更されます。

    シート名の変更

    シート名をダブルクリックして、ビジネスニーズに基づいて名前を変更します。デフォルトでは、Quick BI はローカルファイルのシート名を使用します。

    説明

    シート名には、特殊文字や先頭または末尾のスペースを含めることはできません。

    シートの選択ステータスの変更

    シート名の横にある image アイコンをクリックして、選択ステータスを変更します。デフォルトでは、すべてのシートが選択されています。シートのチェックボックスをオフにすると、そのシートはアップロードされません。

    説明

    ファイルをアップロードするには、少なくとも 1 つのシートを選択する必要があります。

    シートのショートカット

    タブバーの右側にある image アイコンをクリックし、ドロップダウンリストからショートカットを選択します。image

    • 現在のシートのみを選択: 現在のシートのみが選択されます。ファイルがアップロードされると、現在のシートのデータのみが含まれます。

    • すべてのシートを選択: タブバーのすべてのシートが選択されます。ファイルがアップロードされると、すべてのシートのデータが含まれます。

    • 現在のシートを除外: 現在のシートの選択が解除されます。ファイルがアップロードされると、現在のシートのデータは含まれません。

    エリア ②

    ファイル名

    表示名

    Quick BI でのアップロードされたファイルの表示名。ファイルをアップロードすると、システムは自動的にファイル名を表示名として使用します。必要に応じて名前を変更できます。

    説明

    表示名には、特殊文字や先頭または末尾のスペースを含めることはできません。

    物理テーブル名

    ファイルがアップロードされた後、データベースに自動的に作成されるテーブルの名前。必要に応じて物理テーブル名を変更できます。image

    説明

    物理テーブル名には、文字、数字、アンダースコア (_) のみを含めることができます。名前の長さは 150 文字以内である必要があります。

    エリア ③

    ヘッダー行

    ヘッダー行

    ここで現在のシートのヘッダー行を変更できます。

    説明
    • 数値は 0 より大きい整数でなければなりません。

    • ヘッダー行に空のフィールドが含まれていないことを確認してください。そうでない場合、エラーが発生します。

    エリア ④

    データプレビュー

    データプレビュー

    [データプレビュー] タブでは、データをプレビューし、次の操作を実行できます。

    • フィールド名の変更: フィールド名テキストボックスをクリックして、フィールド名を変更します。

    • フィールドタイプの変更: フィールドタイプアイコンをクリックし、ドロップダウンリストからフィールドタイプを選択します。サポートされているタイプは、テキスト、数値、日付です。image

    フィールド詳細

    [フィールド詳細] タブでは、ファイルフィールド名データベースフィールド名、およびフィールドタイプを設定できます。

    ファイルがアップロードされると、データベーステーブルとして保存されます。データベースフィールド名とフィールドタイプは、生成されたデータベーステーブルのフィールド名とタイプとして使用されます。ファイル列名は、データベーステーブルのフィールドコメントになります。

    image

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

  4. ファイルがアップロードされた後、[データソースリストに戻る] をクリックして、アップロードされたファイルデータソースを表示します。image

アップロード済みファイルの変更

ビジネスデータファイルをアップロードした後、ビジネスの変更により更新が必要になる場合があります。データを追加したり、ファイルを置き換えたり、古いファイルを削除したりして、継続的な分析をサポートできます。

ターゲットファイルの右側にある image アイコンをクリックして、[ファイルアップロードの変更] ページに移動します。次の操作を実行できます。image

構成

操作

表示名

Quick BI でのファイルの表示名。この名前は変更できます。

説明

表示名には、特殊文字や先頭または末尾のスペースを含めることはできません。

データプレビュー

データの表示

[追加履歴] パネルで、ファイルを切り替えてデータを表示します。

フィールドの変更

  • フィールド名の変更: フィールド名テキストボックスをクリックして、フィールド名を変更します。

  • フィールドタイプの変更: フィールドタイプアイコンをクリックし、ドロップダウンリストからフィールドタイプを選択します。サポートされているタイプは、テキスト、数値、日付です。image

    説明

    [全体データ] を表示している場合にのみフィールドを変更できます。

フィールド詳細

フィールドの変更

  • フィールド名の変更: ファイル列名テキストボックスをクリックして、フィールド名を変更します。

  • フィールドタイプの変更: フィールドタイプのドロップダウンリストをクリックして、フィールドタイプを選択します。サポートされているタイプは、テキスト、数値、日付です。

  • フィールドの削除: ターゲットフィールドの [アクション] 列にある image アイコンをクリックして、フィールドを削除します。

    説明

    [全体データ] を表示している場合にのみフィールドを変更できます。

フィールドの追加

テーブルの右上隅にある [フィールドの追加] をクリックします。[フィールドの追加] ダイアログボックスで、新しいフィールドの情報を入力し、[OK] をクリックします。

説明

[全体データ] を表示している場合にのみフィールドを追加できます。

image

  • フィールド表示名: Quick BI プラットフォームに追加するフィールドの表示名。

  • 物理フィールド名: 物理データベーステーブルに追加するフィールドの名前。

  • フィールドタイプ: サポートされているタイプは、テキスト、数値、日付です。

追加履歴

追加履歴の表示

[追加履歴] パネルには、追加されたファイルが一覧表示されます。ファイルカードをクリックして、追加されたコンテンツを表示します。

ファイルの追加

ビジネスの成長により新しいビジネスデータファイルが生成された場合、新しいファイルを既存のファイルデータソースに対応するテーブルに追加できます。詳細については、「ファイルの追加」をご参照ください。

ファイルの置き換え

ビジネスの変更により新しいビジネスデータが古いビジネスデータを置き換える必要がある場合、古いファイルを置き換えることができます。詳細については、「ファイルの置き換え」をご参照ください。

ファイルの削除

ビジネスデータファイルにダーティデータが含まれている場合、テーブルに対応するアップロード済みファイルのリストからファイルを削除できます。詳細については、「ファイルの削除」をご参照ください。

ファイルの追加

新しいビジネスデータが生成された場合、それを既存のファイルに追加して、データの最新性と完全性を確保できます。次の手順に従ってください。

  1. [ワークベンチ] にログオンし、[データソース] ページに移動します。[アップロード済みファイル] リストで、ターゲットファイルを見つけ、その名前 (③) または [アクション] 列の image アイコン (④) をクリックします。image

  2. [ファイルアップロードの変更] ページで、右側の [追加] をクリックします。image

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

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

  5. [フィールドマッチング] ステップで、追加するファイルと元のファイルのフィールドを照合します。システムはデフォルトで同じ名前のフィールドを照合します。照合関係は手動で変更できます。名前が異なるフィールドについては、[照合するフィールド] エリアから [フィールドマッチング] エリアに手動でドラッグすることもできます。111

    説明
    • 元のファイルと追加するファイルのフィールドタイプが一致していることを確認してください。そうでない場合、エラーが発生します。照合ルールは次のとおりです:

      • 元のフィールドがテキストの場合: 任意のフィールドタイプと照合できます。

      • 元のフィールドが数値の場合: 数値タイプとのみ照合できます。

      • 元のフィールドが日付の場合: 日付タイプとのみ照合できます。

    • 追加するファイルに元のファイルよりも多くのフィールドがある場合、[フィールドの追加] をクリックして、元のファイルに対応するフィールドを作成して照合できます。余分なフィールドが不要な場合は、次のステップに進むことができます。image

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

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

  6. [確認してアップロード] をクリックします。アップロードが成功すると、追加履歴パネルで追加されたファイルを表示できます。image

  7. (オプション) 追加したファイルを置き換えるには、[追加履歴] パネルに移動し、置き換えたいファイルの横にある image アイコンをクリックします。これにより [ファイルの置き換え] インターフェイスが開き、関連する操作を実行できます。image

ファイルの置き換え

元のファイルの一部のデータを置き換える必要があるが、他のデータはまだ有効な場合、既存のデータソースのデータを置き換えてデータの正確性を維持できます。次の手順に従ってください。

  1. [ファイルアップロードの変更] ページで、[追加履歴] パネルに移動します。置き換えるファイルを選択し、ファイルカードの image アイコンをクリックするか、データテーブルの右上隅にある [データの置き換え] をクリックします。image

  2. [ファイルの置き換え] ページで、新しいファイルをクリックまたはアップロードエリアにドラッグします。image

    説明

    単一シートの置き換えのみがサポートされています。アップロードするファイルに複数のシートがある場合は、アップロードする前にプレビューページで正しいシートを選択してください。

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

  4. [フィールドマッチング] ステップで、置き換えファイルと元のファイルのフィールドを照合します。システムはデフォルトで同じ名前のフィールドを照合します。照合関係は手動で変更できます。名前が異なるフィールドについては、[照合するフィールド] エリアから [フィールドマッチング] エリアに手動でドラッグすることもできます。111

    説明
    • 元のファイルと置き換えファイルのフィールドタイプが一致していることを確認してください。そうでない場合、エラーが発生します。照合ルールは次のとおりです:

      • 元のフィールドがテキストの場合: 任意のフィールドタイプと照合できます。

      • 元のフィールドが数値の場合: 数値タイプとのみ照合できます。

      • 元のフィールドが日付の場合: 日付タイプとのみ照合できます。

    • 置き換えファイルに元のファイルよりも多くのフィールドがある場合、[フィールドの追加] をクリックして、元のファイルに対応するフィールドを作成して照合できます。余分なフィールドが不要な場合は、次のステップに進むことができます。image

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

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

  5. [確認してアップロード] をクリックします。アップロードが成功すると、追加履歴パネルで置き換えられたファイルを表示できます。image

ファイルの削除

ビジネスデータファイルが不要になった場合、またはファイルにダーティデータが含まれている場合は、[ファイルアップロードの変更] ページの [追加履歴] パネルからファイルを選択して削除できます。image

サンプルローカルファイル

次の表に、販売データの構造を示します。

フィールド名

フィールドタイプ

フィールドの説明

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 フォーマットに変換する必要があります。

  1. メモ帳 を使用して CSV ファイルを開きます。

  2. [名前を付けて保存] を選択します。

  3. [エンコーディング] のドロップダウン矢印をクリックします。

  4. [エンコーディング] リストから、[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 ファイルを見つけるには、ファイルタイプのオプションからすべてのファイルを選択する必要があります。