正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

CSVファイル

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

コンマ区切り値(CSV)ファイルは、値を区切るためにコンマを使用する区切りテキストファイルです。ファイルの各行はデータレコードです。各レコードは、コンマで区切られた1つ以上のフィールドで構成されています。フィールド区切り文字としてコンマを使用することが、このファイル形式の名前の由来です。CSVファイルは通常、表形式のデータ(数値とテキスト)をプレーンテキストで保存します。この場合、各行のフィールド数は同じになります。

CSVファイル形式は完全には標準化されていません。他の文字を列区切り文字として使用できます。特殊文字をエスケープするために、フィールドが囲まれている場合と囲まれていない場合があります。

リポジトリに追加すると、.csv拡張子のファイルはGitLabで表示するとテーブルとしてレンダリングされます:

テーブルとしてレンダリングされたCSVファイル

CSV解析に関する考慮事項

GitLabは、Papa Parseライブラリを使用してCSVファイルを解析します。このライブラリはRFC4180に準拠しており、特定のCSV形式で解析のイシューを引き起こす可能性のある厳密な形式要件があります。

例:

  • コンマ(,)区切り文字と二重引用符(")の周りのスペースは、解析エラーを引き起こす可能性があります。
  • コンマと二重引用符の両方を含むフィールドは、パーサーがフィールドの境界を誤って識別する原因となる可能性があります。

次の形式は、解析エラーを引き起こします:

"field1", "field2", "field3"

次の形式は正常に解析されます:

"field1","field2","field3"

CSVファイルがGitLabに正しく表示されない場合:

  • フィールドが二重引用符(")で囲まれている場合は、二重引用符とコンマ(,)区切り文字が間にスペースを入れずにすぐ隣接していることを確認してください。
  • 特殊文字を含むすべてのフィールドを二重引用符(")で囲みます。
  • 変更を加えた後、CSVファイルがGitLabにどのように表示されるかをテストします。

これらの解析要件は、CSVファイルの視覚的なレンダリングにのみ影響し、リポジトリに保存されている実際のファイルコンテンツには影響しません。