0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@Mrs_P

【PowerShell】Excel不要で巨大なCSV/TSVを高速でプレビューできる軽量GUIビューアー

0
Posted at

はじめに

業務でCSVやTSVファイルを扱う際、以下のような悩みに直面したことはないでしょうか？

  • クライアントPCや検証用サーバーに Microsoft Office（Excel）がインストールされていない
  • 巨大なファイルをテキストエディタで開くと、列がズレて中身の構造が把握しにくい
  • Excelで無理に開くと型変換（先頭の「0」消失や日付の変形）が起きてしまう
  • そもそもギガバイト単位の大容量ファイルで、先頭の数十行だけをサクッと確認したい

今回は、Windows標準機能（PowerShell 5.1）のみを使い、Office非搭載のクリーンなWindows環境でもGUI操作で軽快にテキストデータを閲覧できるデータビューアースクリプトを作成しました。

サードパーティ製ツールのインストールが制限されている本番サーバーや作業端末でも、スクリプト1つですぐに利用できます。

動作確認環境

本スクリプトは、以下の標準環境にて動作検証を行っています。追加モジュール等の事前準備は一切不要です。

  • OS: Windows 11 (Home)
  • シェル: Windows PowerShell 5.1
  • 前提ソフト: なし（Microsoft Office / Excel 不要）

このスクリプトの特徴

  1. 完全「Officeレス」で表形式プレビュー
    Windows標準の Out-GridView を利用するため、Excelがなくても直感的な表形式でデータを閲覧できます。カラムヘッダーをクリックした並び替え（ソート）や、検索バーによるリアルタイムフィルタリングも可能です。
  2. 大容量ファイルでもフリーズしない軽量設計
    最初にファイル全体ではなく「先頭51行のみ」を読み込んでデータサイズを判定します。50行を超える場合は、取得したい行数（例: 100行、1000行など）をユーザーに入力させるため、PCのメモリを圧迫しません。
  3. 直感的なGUIダイアログ
    .NETの標準機能を利用し、マウス操作で対象ファイルを選べる「ファイル選択ダイアログ」や、行数を指定する「入力ポップアップ（InputBox）」を実装しています。
  4. カンマ・タブの自動判別
    拡張子（.csv / .tsv）に応じた自動切り替えに加え、拡張子が .txt の場合でも1行目の文字出現頻度から「カンマ区切り」か「タブ区切り」かを自動で推論してパースします。

処理の流れ

スクリプトを実行すると、裏側では以下のようなステップで処理が進みます。

  1. ファイル選択ダイアログの表示
    Windows標準のエクスプローラー風ダイアログが起動し、プレビューしたいテキストファイル（CSV / TSV / TXT）を選択します。
  2. 行数判定とユーザー入力
    先頭51行を高速に事前スキャンします。50行以下の場合は全件表示へ進み、51行以上の場合はポップアップ画面で「先頭何行を取得するか」を半角数字で入力させます（正の整数以外が入力された場合はエラーで安全に終了します）。
  3. 区切り文字のインテリジェント判別
    拡張子をチェックし、.txt などの汎用拡張子の場合は1行目のカンマとタブの個数を比較して、最適な区切り文字を自動決定します。
  4. パイプライン処理による高速抽出と表示
    指定された文字コード（UTF-8）と区切り文字で読み込みを開始し、必要な行数に達した瞬間に処理を打ち切ることで、ギガバイト級のファイルであっても一瞬で Out-GridView 画面にデータをレンダリングします。

使い方

  1. スクリプト（.ps1 ファイル）を任意の場所に配置します。
  2. PowerShellコンソールからスクリプトを実行します。
#  .NETの System.Windows.Forms アセンブリを読み込み、ファイル選択ダイアログなどのGUI機能を利用可能にします。
Add-Type -AssemblyName System.Windows.Forms

#  .NETの Microsoft.VisualBasic アセンブリを読み込み、InputBoxなどの入力機能を利用可能にします。
Add-Type -AssemblyName Microsoft.VisualBasic

#  ファイルを開くためのダイアログ(OpenFileDialog)オブジェクトを新規作成し、変数 $dialog に代入します。
$dialog = New-Object System.Windows.Forms.OpenFileDialog

#  ダイアログ画面のタイトルバーに表示されるメッセージを設定します。
$dialog.Title = "表示したいテキストファイルを選択してください"

#  ダイアログで選択できる拡張子を制限し、CSV, TSV, TXTのみ、またはすべてのファイルを選べるようにフィルターを設定します。
$dialog.Filter = "テキストファイル (*.csv;*.tsv;*.txt)|*.csv;*.tsv;*.txt|すべてのファイル (*.*)|*.*"

#  存在しないファイルが指定された場合にダイアログ側で警告を出すようにし、スクリプト側での存在チェックを不要にします。
$dialog.CheckFileExists = $true

#  ダイアログを画面に表示し、ユーザーが「OK」ボタンを押したかどうかを判定します。
if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
    #  「OK」が押された場合、選択されたファイルのフルパスを変数 $path に格納します。
    $path = $dialog.FileName
#  キャンセルされた場合や、ダイアログの「×」ボタンが押された場合の処理に入ります。
} else {
    #  コンソール画面に黄色い文字でキャンセルされた旨の警告メッセージを表示します。
    Write-Warning "キャンセルされました。"
    #  スクリプトの実行をここで強制終了します。
    exit
#  ファイル選択ダイアログの if-else 分岐を終了します。
}

#  後の Import-Csv と文字コードを統一するため UTF8 を指定し、対象ファイルから先頭最大51行だけを高速に読み込みます。
$peekLines = Get-Content -Path $path -TotalCount 51 -Encoding UTF8

#  対象ファイルが全件表示できるサイズかどうかの判定フラグを、初期値 $false（偽）として定義します。
$isAllData = $false

#  読み込んだファイルの行数が50行以下であるかを判定します。
if ($peekLines.Count -le 50) {
    #  50行以下のため、取得した実際の行数を変数 $rowCount に代入します。
    $rowCount = $peekLines.Count
    #  全データを表示できるため、フラグを $true（真）に変更します。
    $isAllData = $true
#  ファイルが51行以上ある場合の処理に入ります。
} else {
    #  ユーザーに取得したい行数を入力させるための InputBox を表示し、入力された文字列を $inputStr に格納します。
    $inputStr = [Microsoft.VisualBasic.Interaction]::InputBox(
        #  InputBoxに表示する本文です。改行(`r`n)を含めて指示文を記載します。
        "ファイルは50行を超えています。`r`n取得する行数を半角数字で入力してください。`r`n(例: 50, 100, 1000など)", 
        #  InputBoxのタイトルバーに表示する文字列です。
        "行数の指定", 
        #  入力欄に最初から設定しておくデフォルト値（50）です。
        "50"
    #  InputBox を呼び出すメソッドの閉じカッコです。
    )

    #  入力された文字列が空欄、空白のみ、またはキャンセルボタンが押されたかを判定します。
    if ([string]::IsNullOrWhiteSpace($inputStr)) {
        #  キャンセルされたことを示す警告メッセージを表示します。
        Write-Warning "行数の入力がキャンセルされました。"
        #  スクリプトの実行を終了します。
        exit
    #  キャンセル判定の if 文を終了します。
    }

    #  正しい数字が入力されたかを受け取るための変数 $rowCount を 0 で初期化します。
    $rowCount = 0

    #  入力値が整数に変換できない場合、または変換できても 0 以下の数値である場合を判定します。
    if (-not [int]::TryParse($inputStr, [ref]$rowCount) -or $rowCount -le 0) {
        #  正の整数が入力されなかったため、赤字でエラーメッセージを表示します。
        Write-Error "エラー: 正の整数(1以上の数字)を入力してください。入力値: $inputStr"
        #  スクリプトの実行を終了します。
        exit
    #  入力値チェックの if 文を終了します。
    }
#  51行以上の場合の else ブロックを終了します。
}

#  ファイルのパスから拡張子（.csvなど）だけを取り出し、小文字に揃えて変数 $ext に格納します。
$ext = [System.IO.Path]::GetExtension($path).ToLower()

#  拡張子の種類によって、データを区切る文字 ($delimiter) を決定するための条件分岐を開始します。
if ($ext -eq ".csv") {
    #  拡張子が .csv の場合は、無条件でカンマ(",")を区切り文字として設定します。
    $delimiter = ","
#  拡張子が .tsv の場合の条件分岐です。
} elseif ($ext -eq ".tsv") {
    #  拡張子が .tsv の場合は、無条件でタブ("`t")を区切り文字として設定します。
    $delimiter = "`t"
#  拡張子が .txt など、それ以外の場合の処理に入ります。
} else {
    #  ファイルが空ではなく、1行以上のデータが存在することを確認します。
    if ($peekLines.Count -gt 0) {
        #  判定用にファイルの1行目のテキストを変数 $firstLine に取得します。
        $firstLine = $peekLines[0]
        
        #  1行目の全体の文字数からカンマを除外した文字数を引くことで、カンマの出現回数を高速にカウントします。
        $commaCount = $firstLine.Length - $firstLine.Replace(",", "").Length
        
        #  同様に、全体の文字数からタブを除外した文字数を引くことで、タブの出現回数を高速にカウントします。
        $tabCount = $firstLine.Length - $firstLine.Replace("`t", "").Length
        
        #  カンマの数がタブの数より多ければカンマを、そうでなければタブを区切り文字として設定します。
        $delimiter = if ($commaCount -gt $tabCount) { "," } else { "`t" }
    #  ファイルが空（0行）の場合の処理に入ります。
    } else {
        #  データがない場合のデフォルトとして、カンマを区切り文字に設定しておきます。
        $delimiter = ","
    #  ファイル内容による区切り文字判定の if-else ブロックを終了します。
    }
#  拡張子判定の if-elseif-else ブロックを終了します。
}

#  タイトルバーの表示用に、決定した区切り文字がカンマかタブかを判定し、日本語名称を変数に格納します。
$delimiterName = if ($delimiter -eq ",") { "カンマ" } else { "タブ" }

#  最終的にウィンドウへ表示するタイトル文字列を作成し、変数 $windowTitle に格納します。
$windowTitle = if ($isAllData) {
    #  全データを表示する場合のタイトル文字列です。
    "プレビュー (全件) - 区切り文字: $delimiterName"
#  行数指定がされた場合の分岐です。
} else {
    #  指定された行数（$rowCount）をタイトルに組み込んだ文字列です。
    "プレビュー (先頭 $($rowCount) 行) - 区切り文字: $delimiterName"
#  タイトル文字列生成の if-else を終了します。
}

#  指定したファイルパス、区切り文字、UTF-8エンコーディングを用いてファイルの読み込みを開始します。
Import-Csv -Path $path -Delimiter $delimiter -Encoding UTF8 |
    #  パイプラインを利用し、先頭から指定された行数($rowCount)だけを抽出して後続の読み込み処理を打ち切ります。
    Select-Object -First $rowCount |
    #  抽出されたデータを、生成したタイトルと共に Out-GridView（GUIの表画面）へ出力し、表示します。
    Out-GridView -Title $windowTitle

3.表示されるダイアログに従ってファイルを選択し、50行を超える場合は確認したい行数を入力します。
4.別ウィンドウで立ち上がるグリッドビュー上で、ソートやフィルタ機能を活用してデータを確認します。

まとめ

Officeが入っていない環境や本番サーバーにおいて、巨大なCSV/TSVデータの中身を手早く確認する手段として、PowerShell標準機能の組み合わせは非常に強力です。

「Excelを入れるほどではないけれど、テキストエディタのベタ書きでは確認しづらい」という場面でぜひ活用してみてください。

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?