Text/CSV

[アーティクル]
01/24/2024

まとめ

項目	説明
リリース状態	一般提供
製品	Excel Power BI (セマンティックモデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights Analysis Services
関数リファレンスドキュメント	File.Contents Lines.FromBinary Csv.Document

Note

デプロイスケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。

サポートされる機能

インポート

Power Query Desktop からローカルのテキストまたは CSV ファイルに接続する

ローカルのテキストまたは CSV ファイルを読み込むには:

[データの取得] で [テキスト/CSV] オプションを選びます。この操作でローカルファイルブラウザーが起動し、そこでテキストファイルを選択できます。

[開く] を選択して、ファイルを開きます。
[ナビゲーター] から [データの変換] を選んで Power Query エディターのデータを変換することや、[読み込み] を選んでデータを読み込むことができます。

Power Query Online からテキストまたは CSV ファイルに接続する

ローカルのテキストまたは CSV ファイルを読み込むには:

[データソース] ページで、[テキスト/CSV] を選びます。
[接続の設定] に必要なローカルのテキストまたは CSV ファイルのファイルパスを入力します。
[データゲートウェイ] でオンプレミスデータゲートウェイを選択します。
ユーザー名とパスワードを入力します。
[次へ] を選択します。
[ナビゲーター] から [データの変換] を選び、Power Query エディターでデータの変換を開始します。

Web から読み込む

Web からテキストまたは CSV ファイルを読み込むには、Web コネクタを選び、ファイルの Web アドレスを入力して、資格情報のプロンプトに従います。

テキストまたは CSV の区切り記号

Power Query は、CSV をカンマを区切り文字として使用した構造化ファイルとして処理します。これはテキストファイルの特殊なケースです。テキストファイルを選んだ場合、Power Query では、区切り記号で区切られた値があるかどうか、またその区切り記号は何かの判別が自動的に試行されます。区切り記号を推論できた場合、自動的に構造化データソースとして扱われます。

非構造化テキスト

テキストファイルが構造化されていない場合は、ソーステキスト内でエンコードされた 1 行ごとに新しい行を持つ 1 つの列が取得されます。非構造化テキストのサンプルとして、次のような内容のメモ帳ファイルを考えてみましょう。

Hello world.
This is sample data.

これを読み込むと、これらの行を個別の行に読み込むナビゲーション画面が表示されます。

単純な非構造化テキストファイルからデータの読み込み。

このダイアログで構成できるのは、[元のファイル] ドロップダウンの選択のみです。このドロップダウンでは、ファイルの生成に使った文字セットを選択できます。現在、文字セットは推論されず、UTF-8 BOM で始まる場合にのみ、UTF-8 が推論されます。

テキストまたは CSV のファイルカルチャの選択。

CSV

CSV ファイルのサンプルについては、こちらを参照してください。

CSV では、元のファイルに加えて、区切り記号の指定や、データ型の検出方法の指定もサポートしています。

CSV ファイルからのデータの読み込み。

使用できる区切り記号には、コロン、コンマ、等号、セミコロン、スペース、タブ、カスタムの区切り記号 (任意の文字列)、固定幅 (テキストを標準の文字数で分割する) があります。

CSV ファイルの区切り記号の選択。

最後のドロップダウンでは、データ型の検出を処理する方法を選択できます。最初の 200 行を基準にするか、データセット全体を基準にするか、またはデータ型の自動検出を行わず、すべての列の既定値を 'テキスト' にするかを選択できます。警告: データセット全体に対して行うと、エディターでのデータの最初の読み込みに時間がかかる可能性があります。

CSV ファイルのデータ型の推論の選択。

推論が正しくない場合があるので、読み込む前に設定を再確認することをお勧めします。

Structured Text

Power Query がテキストファイルの構造を検出できる場合、テキストファイルは区切り文字で区切られた値ファイルとして扱われ、CSV を開くときに使用できるものと同じオプションが提供されます。CSV は基本的に区切り文字の種類を示す拡張子が付いた単なるファイルです。

たとえば、次の例をテキストファイルとして保存した場合、非構造化テキストではなく、タブ区切り記号があるものとして読み込まれます。

Column 1	Column 2	Column 3
This is a string.	1	ABC123
This is also a string.	2	DEF456

構造化テキストファイルからのデータの読み込み。

これは、他のあらゆる種類の区切り記号ベースのファイルに使用できます。

ソースの編集

ソースステップを編集するときには、最初に読み込んだときとは少し異なるダイアログが表示されます。現在ファイルをどのように扱っているか (つまり、テキストか CSV か) に応じて、さまざまなドロップダウンを含む画面が表示されます。

CSV ファイルにアクセスするクエリのソースステップの編集。

[改行] ドロップダウンでは、引用符内の改行を適用するかどうかを選択できます。

CSV ファイルの改行スタイルの編集。

たとえば、前述の '構造化' サンプルを編集する場合、改行を追加できます。

Column 1	Column 2	Column 3
This is a string.	1	"ABC
123"
This is also a string.	2	"DEF456"

[改行] を [引用符で囲まれた改行を無視] に設定した場合は、改行がないかのように (スペースが追加されて) 読み込まれます。

引用符で囲まれた改行を無視した CSV ファイルの読み込み。

[改行] を [すべての改行を適用] に設定した場合、改行後の内容がその行の唯一の内容となるように、追加の行が読み込まれます (正確な出力はファイル内容の構造によって変わります)。

引用符で囲まれた改行を適用した CSV ファイルの読み込み。

[ファイルを開く形式] ドロップダウンでは、ファイルをロードする形式を編集できます。これはトラブルシューティングに重要です。厳密には CSV ではない構造化ファイル (テキストファイルとして保存されたタブ区切り値ファイルなど) の場合、[形式を指定してファイルを開く] を [CSV] に設定することをお勧めします。この設定にすることで、ダイアログの他の部分で使用できるドロップダウンの種類も決まります。

ファイルの種類の変更。

Text/CSV by Example (例によるテキスト/CSV)

Power Query の Text/CSV By Example は、Power BI Desktop および Power Query Online で一般提供されている機能です。 Text/CSV コネクタを使うと、ナビゲーターの左下隅に [例を使用してテーブルを抽出] というオプションが表示されます。

[例を使用してテーブルを抽出] オプションの使用。

このボタンを選ぶと、[例を使用してテーブルを抽出] ページが表示されます。このページでは、テキストまたは CSV ファイルから抽出するデータのサンプル出力値を指定します。列の最初のセルを入力すると、列の他のセルが入力されます。データを正しく抽出するには、必要に応じて列の複数のセルを入力します。列内の一部のセルが正しくない場合、最初の間違ったセルを修正すると、データは再抽出されます。最初の数セルのデータを確認して、データが正常に抽出されたことを確認します。

Note

例を列順に入力することをお勧めします。列が適切に入力されたら、新しい列を作成して、新しい列に例を入力し始めます。

サンプルの出力値を指定してデータを抽出します。

そのテーブルを構築し終わったら、データの読み込みと変換のいずれかを選びます。結果のクエリには、データ抽出のために推論されたすべてのステップの詳細な内訳が含まれていることに注目してください。これらのステップは単に通常のクエリステップであり、必要に応じてカスタマイズすることができます。

データ抽出のステップの詳細な内訳。

トラブルシューティング

Web からのファイルの読み込み

Web からテキストまたは CSV ファイルを要求し、ヘッダーも昇格させており、スロットリングの可能性を気にする必要があるほどのファイルを取得する場合は、Web.Contents の呼び出しを Binary.Buffer() でラップすることを検討することをお勧めします。この場合、ヘッダーを昇格させる前にファイルをバッファーリングしておくことで、ファイルの要求は 1 回のみになります。

大きな CSV ファイルの操作

Power Query オンラインエディターで大きな CSV ファイルを処理している場合、内部エラーが発生する可能性があります。最初に小さいサイズの CSV ファイルで作業し、エディターで手順を適用し、完了したら、パスを大きい CSV ファイルに変更することをお勧めします。この方法により、作業がより効率的になり、オンラインエディタでタイムアウトが発生する可能性が減ります。タイムアウト期間を長くすることができるため、更新中にこのエラーが発生することは想定されていません。

構造化として解釈される非構造化テキスト

まれに、コンマ数が似ている複数の段落があるドキュメントの場合、CSV と解釈されることがあります。この問題が発生した場合は、Power Query エディターで Sourceステップを編集し、Open File As でCSVではなくTextを選択します。ドロップダウン選択。

Power BI Desktop の列

CSV ファイルをインポートすると、Power BI Desktop は Power Query エディターのステップとして columns=x (x は最初のインポート時の CSV ファイルの列数です) を生成します。後で列を追加し、データソースが更新されるように設定されている場合、最初の列の数 x を超える列は更新されません。

エラー: Connection closed by host (ホストによって接続が閉じられました)

Web ソースからテキストまたは CSV ファイルを読み込み、さらにヘッダーを昇格させる場合は、"An existing connection was forcibly closed by the remote host" または "Received an unexpected EOF or 0 bytes from the transport stream." のエラーが発生することがあります。これらのエラーは、ホストで保護措置が取られ、接続が閉じられたことが原因の可能性があります。これは一時停止の場合があります。たとえば、たとえば、別のデータソース接続で結合または追加操作を待機している場合などです。これらのエラーを回避するには、Binary.Buffer (推奨) または Table.Buffer の呼び出しを追加してみてください。こうすると、ファイルをダウンロードし、メモリに読み込み、すぐに接続を閉じることができます。これにより、ダウンロード中の一時停止を防ぎ、内容を取得する前に、ホストによって強制的に接続が閉じられないようにすることができます。

次の例はこの回避策を示しています。このバッファリングは、結果のテーブルがTable.PromoteHeadersに渡される前に実行する必要があります。

元のコード:

Csv.Document(Web.Contents("https://.../MyFile.csv"))

Binary.Buffer を使用する場合:

Csv.Document(Binary.Buffer(Web.Contents("https://.../MyFile.csv")))

Table.Buffer を使用する場合:

Table.Buffer(Csv.Document(Web.Contents("https://.../MyFile.csv")))

次の方法で共有