PowerShell: 多次元連想配列（ハッシュテーブル）を作成・操作する

PowerShellの多次元連想配列（ハッシュテーブル）は、 複雑なデータ構造を効率的に管理するための強力なツールです。 この記事では、多次元連想配列の基本概念から作成方法、操作方法、 そして実践的な活用シナリオまでを詳しく解説します。

多次元連想配列（ハッシュテーブル）とは？

多次元連想配列は、通常の連想配列（ハッシュテーブル）を拡張したデータ構造です。PowerShellでは、これを入れ子構造のハッシュテーブルとして実現します。

特徴：

  • キーと値のペアを持つ
  • 値として別のハッシュテーブルを含むことができる
  • 複雑な階層構造のデータを表現可能

利点：

  • データの整理と検索が容易
  • 複雑なデータ構造を直感的に表現できる
  • JSONやXMLのような階層データの操作に適している

多次元連想配列の作成

PowerShellで多次元連想配列を作成する基本的な方法を見ていきましょう。

$multiDimHash = @{
    "部門A" = @{
        "チーム1" = @{
            "メンバー1" = "山田太郎"
            "メンバー2" = "鈴木花子"
        }
        "チーム2" = @{
            "メンバー1" = "佐藤次郎"
            "メンバー2" = "高橋明子"
        }
    }
    "部門B" = @{
        "チーム3" = @{
            "メンバー1" = "田中一郎"
            "メンバー2" = "伊藤さゆり"
        }
    }
}

この例では、会社の組織構造を表現しています。部門、チーム、メンバーという3層構造になっています。

値の参照

多次元連想配列から値を参照するには、ドット記法または角括弧記法を使用します。

# ドット記法
Write-Host $multiDimHash.部門A.チーム1.メンバー1  # 出力: 山田太郎

# 角括弧記法
Write-Host $multiDimHash["部門B"]["チーム3"]["メンバー2"]  # 出力: 伊藤さゆり

# 混合記法
Write-Host $multiDimHash.部門A["チーム2"].メンバー1  # 出力: 佐藤次郎

存在しないキーにアクセスする場合は、エラーを防ぐためにnullチェックを行うことをお勧めします。

if ($multiDimHash.部門C -and $multiDimHash.部門C.チーム4) {
    Write-Host $multiDimHash.部門C.チーム4.メンバー1
} else {
    Write-Host "指定されたパスは存在しません。"
}

値の変更

既存の値を変更するには、単純に新しい値を代入します。

$multiDimHash.部門A.チーム1.メンバー1 = "山田花子"
Write-Host $multiDimHash.部門A.チーム1.メンバー1  # 出力: 山田花子

要素（キー・値）の追加

新しい要素を追加するには、Addメソッドを使用するか、直接代入します。

# 新しい部門を追加
$multiDimHash.Add("部門C", @{})

# 新しいチームを追加
$multiDimHash.部門C["チーム5"] = @{}

# 新しいメンバーを追加
$multiDimHash.部門C.チーム5.メンバー1 = "中村健太"

Write-Host $multiDimHash.部門C.チーム5.メンバー1  # 出力: 中村健太

要素（キー・値）の削除

要素を削除するには、Removeメソッドを使用します。

$multiDimHash.部門A.チーム1.Remove("メンバー2")
$multiDimHash.部門B.Remove("チーム3")

# 削除されたことを確認
if (-not $multiDimHash.部門A.チーム1.メンバー2) {
    Write-Host "メンバー2は削除されました。"
}

if (-not $multiDimHash.部門B.チーム3) {
    Write-Host "チーム3は削除されました。"
}

実践例: 多次元連想配列の活用シナリオ

1. 設定ファイルの管理

複雑な設定情報を多次元連想配列で管理し、JSON形式で保存・読み込みする例を見てみましょう。

$config = @{
    "Database" = @{
        "ConnectionString" = "Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;"
        "MaxConnections" = 100
        "Timeout" = 30
    }
    "Logging" = @{
        "LogLevel" = "Info"
        "LogFile" = "C:\Logs\app.log"
        "MaxFileSize" = "10MB"
    }
    "Security" = @{
        "EnableSSL" = $true
        "AllowedIPs" = @("192.168.1.1", "10.0.0.1")
    }
}

# JSONとして保存
$config | ConvertTo-Json -Depth 5 | Set-Content "config.json"

# JSONから読み込み
$loadedConfig = Get-Content "config.json" | ConvertFrom-Json

# 設定値の使用
$connectionString = $loadedConfig.Database.ConnectionString
$logLevel = $loadedConfig.Logging.LogLevel

Write-Host "Connection String: $connectionString"
Write-Host "Log Level: $logLevel"

2. 階層的なデータ分析

売上データを多次元連想配列で表現し、分析する例を見てみましょう。

$salesData = @{
    "2023" = @{
        "Q1" = @{
            "Product A" = 1000
            "Product B" = 1500
        }
        "Q2" = @{
            "Product A" = 1200
            "Product B" = 1800
        }
    }
    "2024" = @{
        "Q1" = @{
            "Product A" = 1100
            "Product B" = 1600
        }
    }
}

function Get-TotalSales {
    param (
        [Parameter(Mandatory=$true)]
        [hashtable]$Data,
        [string]$Year,
        [string]$Quarter
    )

    $total = 0
    if ($Year -and $Quarter) {
        $total = ($Data[$Year][$Quarter].Values | Measure-Object -Sum).Sum
    } elseif ($Year) {
        $Data[$Year].Values | ForEach-Object {
            $total += ($_.Values | Measure-Object -Sum).Sum
        }
    } else {
        $Data.Values | ForEach-Object {
            $_.Values | ForEach-Object {
                $total += ($_.Values | Measure-Object -Sum).Sum
            }
        }
    }
    return $total
}

$totalSales2023 = Get-TotalSales -Data $salesData -Year "2023"
$totalSalesQ12024 = Get-TotalSales -Data $salesData -Year "2024" -Quarter "Q1"

Write-Host "Total Sales 2023: $totalSales2023"
Write-Host "Total Sales Q1 2024: $totalSalesQ12024"

この例では、多次元連想配列を使用して年、四半期、製品ごとの売上データを構造化し、特定の期間の合計売上を計算する関数を実装しています。

多次元連想配列は、PowerShellで複雑なデータ構造を扱う際に非常に有用です。適切に使用することで、データの整理、アクセス、分析が容易になり、より効率的なスクリプト開発が可能になります。実際の業務やプロジェクトでこれらの技術を活用し、PowerShellスクリプトの可能性を最大限に引き出しましょう。

PowerShell