はい、承知いたしました。PowerShellでSQLiteデータベースを扱う基本的な方法について、約5000語の詳細な解説を含む記事を作成します。

PowerShellでSQLiteデータベースを扱う基本：詳細解説

はじめに

現代のシステム管理やデータ処理において、データベースは不可欠な要素です。大規模なエンタープライズシステムではSQL ServerやOracle、MySQLといったクライアント/サーバー型データベースが利用されますが、より軽量で手軽に扱えるデータベースが必要な場面も多く存在します。そのような場面でしばしば登場するのが「SQLite」です。

SQLiteは、その名の通り「Lite（軽量）」なデータベースエンジンです。サーバープロセスを必要とせず、データベース全体が単一のファイルとして保存されるという特徴を持ちます。この特性から、設定ファイルの保存、小規模なアプリケーションのデータストア、ローカル環境でのデータ分析など、多様な用途で利用されています。

PowerShellは、Windows環境における強力な自動化ツールであり、システム管理、スクリプト作成、データ処理など、幅広いタスクに使用されます。PowerShellからデータベースを操作できれば、これらのタスクの幅が大きく広がります。

この記事では、PowerShellを使用してSQLiteデータベースを操作するための基本的な方法を、詳細なコード例とともに解説します。データベースの接続、SQLコマンドの実行（データの挿入、取得、更新、削除）、トランザクション処理、エラーハンドリングといった、データベース操作の基礎となる概念を、PowerShellスクリプトの視点から深く掘り下げていきます。約5000語というボリュームで、初心者でも理解できるよう、各ステップを丁寧に説明します。

PowerShellスクリプト内でデータを永続化したい、設定情報をファイルよりも構造的に管理したい、簡単なローカルデータ分析を行いたい、といったニーズを持つ読者にとって、この記事がSQLiteとPowerShellを組み合わせたデータ管理の強力な一歩となることを願っています。

第1章: SQLiteの基本

PowerShellからの操作に入る前に、SQLiteがどのようなデータベースであるか、その基本的な特徴を理解しておきましょう。

1.1 SQLiteとは？

SQLiteは、組み込み型のリレーショナルデータベースエンジンです。他の多くのデータベースシステム（MySQL, PostgreSQL, SQL Serverなど）とは異なり、独立したサーバープロセスとして動作しません。代わりに、アプリケーション内にライブラリとして組み込まれ、データベースファイル（通常 .db や .sqlite 拡張子の単一ファイル）を直接読み書きします。

この「サーバーレス」という特徴が、SQLiteの最大の利点の一つです。インストールや設定が非常に簡単で、複雑なセットアップや管理作業が不要です。単一ファイルをコピーするだけでデータベースをバックアップしたり移動したりできます。

1.2 SQLiteの主な特徴

サーバーレス: 専用のサーバープロセスは不要。アプリケーションが直接データベースファイルを操作します。
トランザクショナル: ACID（原子性、一貫性、独立性、永続性）特性を満たすトランザクションをサポートします。これにより、複数の操作をまとめて実行し、途中でエラーが発生した場合に全体の変更を取り消すことができます。
ファイルベース: データベース全体が単一のファイルに保存されます。これにより、バックアップや移動が容易になります。
ライセンスフリー: パブリックドメインとして公開されており、商用・非商用を問わず自由に利用、配布、改変できます。
軽量: ディスク容量やメモリ使用量が少なく、リソースの限られた環境でも動作します。
標準SQLのサポート: SQL-92標準の多くの機能（基本的なクエリ、結合、集約関数、トリガーなど）をサポートしています。ただし、一部の高度な機能（ユーザー定義関数、ストアドプロシージャなど）は制限があります。

1.3 SQLiteの用途

SQLiteのこれらの特徴から、以下のような用途に適しています。

デスクトップアプリケーションのデータストレージ（例: Webブラウザの履歴、写真管理ソフトのメタデータ）
モバイルアプリケーションのデータストレージ
組み込みシステム（例: スマートフォン、家電製品）
開発・テスト環境でのデータ管理
設定ファイルの管理
ログデータの収集
小規模なWebサイトやスクリプトのデータストア
教育用データベース

PowerShellの文脈では、スクリプトで収集したデータの保存、ツールが使用する設定情報の永続化、簡単なレポート生成のためのデータ集計などに非常に便利です。

第2章: なぜPowerShellとSQLiteなのか

PowerShellでSQLiteを扱うことのメリットは、両者の特徴を組み合わせることで生まれます。

2.1 PowerShellのデータ処理能力

PowerShellはオブジェクト指向のシェルであり、様々な形式のデータを柔軟に扱うことができます。テキストファイル、CSV、XML、JSON、WMI、レジストリなど、多種多様なソースからデータを取り込み、加工し、出力する機能が豊富です。

しかし、PowerShellの変数はスクリプトの実行中にのみメモリ上に存在し、スクリプトが終了すると消滅します。データを永続化するためには、ファイルに書き出す必要があります。

2.2 データ永続化の課題とデータベースの利点

データをファイルに書き出す方法はいくつかあります。

テキストファイル: シンプルですが、構造化されたデータの管理や検索には不向きです。
CSV/JSON: ある程度の構造化は可能ですが、データの追加・更新・削除が非効率的になりがちです。また、リレーショナルな関連性を持つデータや、複雑な検索条件には対応できません。
XML: 構造化されたデータには適していますが、クエリが複雑になったり、ファイルサイズが大きくなりがちです。

これらのファイルベースの方法に対し、データベースは以下のような利点を提供します。

構造化: データをテーブル、行、列といった厳格な構造で管理します。
整合性: 制約（主キー、外部キー、NOT NULLなど）によりデータの整合性を保ちます。
検索・集計: SQLという強力なクエリ言語を用いて、複雑な条件でのデータ検索、結合、集計を効率的に行えます。
更新・削除: 特定の条件に合致するデータを効率的に更新または削除できます。
トランザクション: 複数の操作をまとめて実行し、原子性と一貫性を保証します。

2.3 PowerShellとSQLiteの組み合わせのメリット

PowerShellの強力な自動化・データ処理能力と、SQLiteの軽量かつファイルベースのデータベース機能が組み合わさることで、以下のようなメリットが生まれます。

簡単なデータ永続化: スクリプトで収集したデータを、構造を維持したまま簡単にファイルに保存できます。
効率的なデータ管理: SQLを使って、ファイルIOよりもはるかに効率的にデータの検索、フィルタリング、集計、更新、削除ができます。
設定情報の構造化: スクリプトの設定情報をテーブル形式で管理することで、柔軟なアクセスや更新が可能になります。
移植性の高さ: SQLiteデータベースファイルは単なるファイルなので、スクリプトとセットで簡単に他のシステムに配布できます。
学習コスト: SQLの基本的な知識があればすぐに始められます。また、PowerShellの既存のスキルを活用できます。
依存性の少なさ: 専用のサーバーや複雑な設定が不要なため、依存性が少なく、様々な環境で動作させやすいです。

このように、PowerShellとSQLiteの組み合わせは、特に「サーバーレスで手軽に、しかし構造的かつ効率的にデータを扱いたい」というPowerShellスクリプトのニーズに非常に適しています。

第3章: 環境構築

PowerShellからSQLiteを操作するためには、SQLiteデータベースエンジンと通信するためのライブラリが必要です。PowerShellは.NET Frameworkまたは.NET Core/.NET 5+上で動作するため、これらのプラットフォーム向けのSQLiteライブラリを利用します。最も一般的に使用されるのは、System.Data.SQLiteまたはより新しいMicrosoft.Data.Sqliteです。

この記事では、PowerShell Core (PowerShell 7以降) または最新のPowerShell Desktopで利用可能な、よりモダンなMicrosoft.Data.Sqliteライブラリの使用を推奨します。このライブラリは.NET標準に準拠しており、クロスプラットフォーム互換性が高いです。

Microsoft.Data.Sqliteを利用するための最も簡単な方法は、NuGetパッケージとして提供されているものをPowerShellのモジュールとして読み込むことです。

3.1 `Microsoft.Data.Sqlite` モジュールのインストール

NuGetパッケージは直接PowerShellモジュールとしてインストールできません。しかし、NuGetパッケージをPowerShellのモジュールシステムに統合するための便利なツールキットが存在します。ここでは、Microsoft.Data.Sqlite.Toolsモジュールを使用します。このモジュールは内部的に Microsoft.Data.Sqlite NuGetパッケージを管理・利用可能にしてくれます。

まず、Microsoft.Data.Sqlite.Toolsモジュールをインストールします。管理者権限が必要になる場合があります。

“`powershell

現在のユーザーにインストールする場合 (管理者権限不要だが、モジュールパスに注意)

Install-Module -Name Microsoft.Data.Sqlite.Tools -Scope CurrentUser

全ユーザーにインストールする場合 (管理者権限が必要)

Install-Module -Name Microsoft.Data.Sqlite.Tools -Scope AllUsers

“`

インストールが完了したら、モジュールをインポートします。

powershell Import-Module Microsoft.Data.Sqlite.Tools

このモジュールをインポートすると、Microsoft.Data.SqliteライブラリのアセンブリがPowerShellセッションにロードされ、その中のクラス（Microsoft.Data.Sqlite.SqliteConnection, Microsoft.Data.Sqlite.SqliteCommandなど）が利用可能になります。

注意点:
* Install-Moduleコマンドが利用できない場合は、PowerShellGetモジュールが最新でない可能性があります。Update-Module -Name PowerShellGetを試してください。
* ファイアウォールの設定によってはNuGetギャラリーへのアクセスがブロックされることがあります。
* 古いWindows PowerShell (.NET Framework) では、System.Data.SQLiteを直接アセンブリとしてロードするか、NuGetパッケージを手動でダウンロードしてAdd-Typeで読み込む方法が一般的でした。本記事ではPowerShell Core/7+を前提としており、Microsoft.Data.Sqlite.Toolsモジュールが最もスムーズな方法です。

これで、PowerShellスクリプト内でSQLiteデータベースを操作するための準備が整いました。

第4章: データベース接続の管理

データベースを操作する最初のステップは、データベースファイルへの接続を確立することです。PowerShellでSQLiteを操作する場合、.NETのデータアクセス技術であるADO.NETのクラスを利用します。具体的には、Microsoft.Data.Sqlite.SqliteConnectionクラスを使用します。

4.1 接続文字列

データベースに接続するためには、「接続文字列 (Connection String)」が必要です。SQLiteの場合、接続文字列は非常にシンプルで、通常はデータベースファイルのパスを指定します。

新しいデータベースを作成する場合: 存在しないファイルを指定すると、接続時に新しいデータベースファイルが作成されます。
Data Source=C:\path\to\MyDatabase.db
既存のデータベースに接続する場合: 既存ファイルのパスを指定します。
Data Source=.\ExistingDatabase.sqlite
インメモリデータベース: ファイルではなく、メモリ上に一時的なデータベースを作成することもできます。これはテストなどに便利ですが、PowerShellセッションが終了するとデータは失われます。
Data Source=:memory:

4.2 データベースへの接続を開く

SqliteConnectionオブジェクトを作成し、Open()メソッドを呼び出すことで、データベースへの接続を確立します。

“`powershell

データベースファイルのパスを指定

$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”

SqliteConnectionオブジェクトを作成

$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)

接続を開く

try {
$connection.Open()
Write-Host “データベース接続に成功しました: $($dbPath)”
}
catch {
Write-Error “データベース接続エラー: $($_.Exception.Message)”
# エラー発生時は接続オブジェクトを破棄
if ($connection) {
$connection.Dispose()
}
exit
}
“`

New-Objectコマンドレットを使用してMicrosoft.Data.Sqlite.SqliteConnectionクラスのインスタンスを作成し、コンストラクタに接続文字列を渡しています。$connection.Open()で実際に接続を確立します。try/catchブロックを使用しているのは、ファイルのパスが不正だったり、ファイルにアクセスできなかったりした場合にエラーを捕捉するためです。

4.3 データベース接続を閉じる

データベースへの接続は、操作が完了したら必ず閉じる必要があります。これにより、リソースが解放され、他のプロセスからのデータベースファイルへのアクセスが可能になります。Close()メソッドまたはDispose()メソッドを使用します。

“`powershell

データベース操作が完了した後…

if ($connection.State -eq [System.Data.ConnectionState]::Open) {
$connection.Close()
Write-Host “データベース接続を閉じました。”
}

または、リソース解放を確実に行うためにDispose()を使用

if ($connection) {
$connection.Dispose()
$connection = $null # オブジェクト参照をクリア
Write-Host “データベース接続オブジェクトを破棄しました。”
}
“`

Close()は接続を閉じますが、オブジェクト自体はメモリに残ります。Dispose()は接続を閉じるとともに、オブジェクトが使用しているリソースを解放します。ADO.NETオブジェクトはIDisposableインターフェースを実装しているため、明示的にDispose()を呼び出すか、後述するusing文に相当するパターンを使用することが推奨されます。

4.4 `using`ステートメントに相当するパターン

C#などの言語にあるusingステートメントは、IDisposableオブジェクトのリソース解放を保証する便利な構文です。PowerShellには直接的なusingステートメントはありませんが、同様のパターンをtry/finallyブロックを使って実現できます。

“`powershell

データベースファイルのパス

$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”

$connection = $null # 初期化

try {
# SqliteConnectionオブジェクトを作成
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)

# 接続を開く
$connection.Open()
Write-Host "データベース接続に成功しました。"

# --- ここでデータベース操作を行う ---
Write-Host "データベース操作を実行します..."
# 例: シンプルなクエリ実行 (後述)
# ...
# ------------------------------------

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
# 接続オブジェクトが存在し、IDisposableを実装していれば破棄する
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
Write-Host “データベース接続オブジェクトを破棄しました (finallyブロック)。”
}
}
“`

このtry/finallyパターンを使用することで、スクリプトの実行中にエラーが発生した場合でも、finallyブロックが必ず実行され、データベース接続が適切に閉じられ、リソースが解放されることが保証されます。大規模なスクリプトや、エラーの可能性がある操作を含む場合には、このパターンを使用することを強く推奨します。以降の例では、簡潔さのためにfinallyを省略する場合もありますが、実践的なスクリプトでは常にリソース管理を考慮してください。

第5章: SQLコマンドの実行

データベースへの接続を確立したら、次はSQLコマンドを実行してデータを操作します。PowerShellからSQLを実行するには、Microsoft.Data.Sqlite.SqliteCommandクラスを使用します。

SqliteCommandオブジェクトは、実行したいSQLステートメントと、そのステートメントを実行するためのSqliteConnectionオブジェクトを結びつけます。

SQLコマンドの実行方法は、そのコマンドがデータを返すかどうかによって大きく分けられます。

非クエリコマンド (Non-Query Commands): CREATE TABLE, INSERT, UPDATE, DELETE, DROP TABLEなど、データベースの状態を変更するコマンド。これらのコマンドはデータを返しません（実行された行数などを返します）。ExecuteNonQuery()メソッドを使用します。
クエリコマンド (Query Commands): SELECTなど、データベースからデータを取得するコマンド。これらのコマンドは結果セット（データの集合）を返します。ExecuteReader()メソッドを使用します。
スカラコマンド (Scalar Commands): SELECT COUNT(*), SELECT MAX(column)など、単一の値を返すコマンド。ExecuteScalar()メソッドを使用します。

各実行方法について詳しく見ていきましょう。

5.1 非クエリコマンド (`ExecuteNonQuery()`)

テーブルの作成、データの挿入、更新、削除など、データベースの構造や内容を変更するコマンドを実行するにはExecuteNonQuery()を使用します。このメソッドは、コマンドによって影響を受けた行数を整数で返します。

例 5.1.1: テーブルの作成 (CREATE TABLE)

まず、接続を開き、テーブルを作成するSQLコマンドを実行します。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# SQLステートメントを定義
$sql = @"

CREATE TABLE IF NOT EXISTS Users (
UserId INTEGER PRIMARY KEY AUTOINCREMENT,
UserName TEXT NOT NULL UNIQUE,
Email TEXT
);
“@
$command.CommandText = $sql

Write-Host "テーブルを作成します..."
# SQLコマンドを実行 (データを返さない)
$rowsAffected = $command.ExecuteNonQuery()

Write-Host "テーブル作成コマンドが実行されました。"
# CREATE TABLEは通常0を返すが、IF NOT EXISTSで既に存在する場合は0以外の可能性もある

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

New-Object Microsoft.Data.Sqlite.SqliteCommand()でコマンドオブジェクトを作成します。
$command.Connection = $connectionで、どの接続でこのコマンドを実行するかを指定します。
$sql = @" ... "@で、複数行のSQLステートメントを変数に格納しています。ここでは、Usersという名前のテーブルを作成しています。IF NOT EXISTS句は、テーブルが既に存在する場合にエラーになるのを防ぎます。
$command.CommandText = $sqlで、コマンドオブジェクトに実行するSQLステートメントを設定します。
$command.ExecuteNonQuery()を呼び出してSQLを実行します。

例 5.1.2: データの挿入 (INSERT INTO)

作成したテーブルにデータを挿入します。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 挿入するSQLステートメント
# NOTE: VALUES句に直接値を埋め込むのは推奨されません (SQLインジェクションの危険性、型変換の問題)。
#       次章でパラメータを使う方法を説明します。ここでは単純な例として示します。
$sqlInsert = @"

INSERT INTO Users (UserName, Email) VALUES (‘Alice’, ‘[email protected]’);
“@
$command.CommandText = $sqlInsert

Write-Host "データを挿入します (Alice)..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が挿入されました。"

# 別のデータを挿入
$sqlInsert2 = @"

INSERT INTO Users (UserName, Email) VALUES (‘Bob’, ‘[email protected]’);
“@
$command.CommandText = $sqlInsert2
Write-Host “データを挿入します (Bob)…”
$rowsAffected2 = $command.ExecuteNonQuery()
Write-Host “$($rowsAffected2) 行が挿入されました。”

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

この例では、INSERT INTOステートメントを実行しています。ExecuteNonQuery()は、挿入された行数（この場合は1）を返します。

重要: 上記の例ではSQLステートメントの中に直接値を埋め込んでいますが、これは非常に危険であり、SQLインジェクション攻撃のリスクを高めます。また、文字列の中にクォーテーションを含んでいたり、データ型が一致しなかったりする場合にエラーの原因となります。常にパラメータを使用することを強く推奨します。 パラメータの利用については、次章で詳しく解説します。

5.2 クエリコマンド (`ExecuteReader()`)

データベースからデータを取得するにはExecuteReader()メソッドを使用します。このメソッドはMicrosoft.Data.Sqlite.SqliteDataReaderオブジェクトを返します。データリーダーは取得した結果セット内の行を順方向にのみ読み進めることができます。

ExecuteReader()を使用する典型的なパターンは以下のようになります。

SqliteCommandオブジェクトを作成し、SELECTステートメントを設定します。
$reader = $command.ExecuteReader()を実行してSqliteDataReaderオブジェクトを取得します。
$reader.Read()メソッドを使用して、結果セットの次の行に進みます。Read()は行が存在すれば$trueを、すべて読み終えれば$falseを返します。
Read()が$trueを返している間、現在の行の列データにアクセスします。列の値は $reader["列名"] または $reader.GetValue(列インデックス) で取得できます。列のインデックスは0から始まります。
すべての行を読み終えたら、$reader.Close()を呼び出してリーダーを閉じ、リソースを解放します。データリーダーもIDisposableを実装しているため、try/finallyまたは同様のパターンでリソース解放を保証することが推奨されます。

例 5.2.1: 全データの取得 (SELECT *)

先ほど挿入したデータをすべて取得してみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null
$reader = $null # DataReaderオブジェクトも解放する必要がある

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 取得するSQLステートメント
$sqlSelect = "SELECT UserId, UserName, Email FROM Users;"
$command.CommandText = $sqlSelect

Write-Host "データを取得します..."
# SQLコマンドを実行し、DataReaderを取得
$reader = $command.ExecuteReader()

# 結果セットが存在するか確認
if ($reader.HasRows) {
    Write-Host "取得したデータ:"
    # 各行をループして読み込む
    while ($reader.Read()) {
        # 列の値にアクセス (列名またはインデックス)
        $userId = $reader["UserId"]      # または $reader.GetValue(0)
        $userName = $reader["UserName"]  # または $reader.GetValue(1)
        $email = $reader["Email"]        # または $reader.GetValue(2)

        Write-Host "  UserId: $userId, UserName: $userName, Email: $email"
    }
}
else {
    Write-Host "データは存在しません。"
}

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
# DataReaderが存在し、IDisposableを実装していれば破棄
if ($reader -is [System.IDisposable]) {
$reader.Dispose()
Write-Host “DataReaderオブジェクトを破棄しました。”
}
# Connectionが存在し、IDisposableを実装していれば破棄
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
Write-Host “Connectionオブジェクトを破棄しました。”
}
}
“`

この例では、ExecuteReader()から取得した$readerオブジェクトを使って、while ($reader.Read())ループで各行を読み進めています。各行の中で、列名を使ってデータにアクセスしています。読み取りが完了したら、$reader.Dispose()を呼び出すことを忘れないでください。

5.3 スカラコマンド (`ExecuteScalar()`)

単一の値（例えば、テーブルの行数、最大値、合計値など）を取得したい場合は、ExecuteScalar()メソッドが便利です。このメソッドは、クエリの結果セットの最初の行の最初の列の値を返します。結果が複数行、複数列であっても、取得されるのはその一つだけです。戻り値はobject型なので、必要に応じて適切な型にキャストする必要があります。

例 5.3.1: 行数のカウント (SELECT COUNT(*))

Usersテーブルに登録されているユーザー数をカウントしてみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 行数をカウントするSQLステートメント
$sqlCount = "SELECT COUNT(*) FROM Users;"
$command.CommandText = $sqlCount

Write-Host "ユーザー数をカウントします..."
# SQLコマンドを実行し、単一の値を取得
$userCountObject = $command.ExecuteScalar()

# 戻り値はobject型なので、整数型にキャスト
$userCount = [int]$userCountObject

Write-Host "登録されているユーザー数: $userCount"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

ExecuteScalar()は戻り値がobject型なので、[int]で明示的に整数型にキャストしています。

5.4 データの更新 (`UPDATE`) および削除 (`DELETE`)

データの更新と削除もExecuteNonQuery()を使用します。WHERE句を使って、操作対象の行を特定するのが一般的です。

例 5.4.1: データの更新 (UPDATE)

UserIdが1のユーザーのメールアドレスを更新してみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 更新するSQLステートメント (NOTE: パラメータを使っていない例)
$sql = @"

UPDATE Users
SET Email = ‘[email protected]’
WHERE UserId = 1;
“@
$command.CommandText = $sql

Write-Host "UserId 1 のユーザー情報を更新します..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が更新されました。"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

例 5.4.2: データの削除 (DELETE)

UserIdが2のユーザーを削除してみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 削除するSQLステートメント (NOTE: パラメータを使っていない例)
$sql = @"

DELETE FROM Users
WHERE UserId = 2;
“@
$command.CommandText = $sql

Write-Host "UserId 2 のユーザー情報を削除します..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が削除されました。"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

これらの例でも、SQLステートメントに直接値を埋め込んでいますが、繰り返しになりますがこれは非推奨です。次章でパラメータを使ったより安全な方法を学びます。

第6章: パラメータの利用

SQLステートメントに外部から値を渡す場合、値を直接SQL文字列に埋め込むのではなく、パラメータ (Parameters) を利用することが強く推奨されます。パラメータを利用する主な理由は以下の通りです。

セキュリティ (SQLインジェクションの防止): ユーザーからの入力やスクリプト中の変数を直接SQL文字列に結合すると、悪意のあるコードが挿入される可能性があります。パラメータを使用すると、値はデータとして扱われ、SQLコードの一部として解釈されないため、SQLインジェクションを防ぐことができます。
データ型の扱い: パラメータを使用すると、PowerShell/.NETのデータ型とデータベースのデータ型との間の変換をADO.NETプロバイダ（この場合はMicrosoft.Data.Sqlite）が適切に処理してくれます。文字列のエスケープ処理などを手動で行う必要がなくなります。
可読性と保守性: SQLステートメントと値を分離することで、コードの可読性が向上し、保守が容易になります。
パフォーマンス: 同じSQLステートメントを異なるパラメータ値で繰り返し実行する場合、データベースがクエリ実行プランをキャッシュできるため、パフォーマンスが向上する可能性があります。

PowerShellでSQLiteのパラメータを利用するには、SqliteCommandオブジェクトのParametersコレクションにSqliteParameterオブジェクトを追加します。

6.1 パラメータの使用方法

パラメータを使用する手順は以下の通りです。

SQLステートメントの中で、値を使用したい場所にパラメータのプレースホルダを記述します。SQLiteでは、@parametername形式（名前付きパラメータ）または?形式（位置指定パラメータ）を使用できますが、名前付きパラメータの方が可読性が高く推奨されます。
SqliteCommandオブジェクトを作成し、CommandTextにパラメータ付きのSQLステートメントを設定します。
$command.Parameters.Add()または$command.Parameters.AddWithValue()メソッドを使用して、パラメータコレクションにパラメータを追加します。追加する際には、パラメータ名と対応する値を指定します。

例 6.1.1: パラメータを使ったデータの挿入 (INSERT INTO)

例 5.1.2 のデータ挿入をパラメータを使って書き直してみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# パラメータを使ったINSERTステートメント
$sqlInsert = @"

INSERT INTO Users (UserName, Email) VALUES (@userName, @email);
“@
$command.CommandText = $sqlInsert

# --- パラメータを定義して値を追加 ---
# SqliteParameterオブジェクトを作成してAddする
# $paramName = New-Object Microsoft.Data.Sqlite.SqliteParameter("@userName", [System.Data.DbType]::String)
# $paramName.Value = "Charlie"
# $command.Parameters.Add($paramName)

# SqliteParameterオブジェクトを直接Addする
# $command.Parameters.Add((New-Object Microsoft.Data.Sqlite.SqliteParameter("@email", [System.Data.DbType]::String)))
# $command.Parameters["@email"].Value = "[email protected]"

# 最も簡単な方法: AddWithValue()
$command.Parameters.AddWithValue("@userName", "Charlie")
$command.Parameters.AddWithValue("@email", "[email protected]")
# AddWithValueは便利だが、大きなデータやNULL値を扱う場合は
# DbTypeを明示的に指定するAddメソッドの方が厳密な型制御ができる場合がある。

Write-Host "データを挿入します (Charlie)..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が挿入されました。"

# 別のデータを挿入 (パラメータの値を変更して再利用)
$command.Parameters["@userName"].Value = "David"
$command.Parameters["@email"].Value = "[email protected]"

Write-Host "データを挿入します (David)..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が挿入されました。"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

この例では、VALUES句に@userNameと@emailという名前付きパラメータを使用しています。そして、$command.Parameters.AddWithValue()を使って、それぞれのパラメータに値を設定しています。同じコマンドオブジェクトとパラメータ定義を再利用し、パラメータの値だけを変更して何度も実行することも可能です。

6.2 パラメータを使ったデータの選択 (`SELECT`)

SELECTステートメントのWHERE句などで条件を指定する際にもパラメータは非常に有効です。

例 6.2.1: パラメータを使った条件指定クエリ (SELECT WHERE)

特定のユーザー名のユーザー情報を取得してみましょう。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null
$reader = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# パラメータを使ったSELECTステートメント
$sqlSelect = @"

SELECT UserId, UserName, Email FROM Users
WHERE UserName = @targetUserName;
“@
$command.CommandText = $sqlSelect

# 取得したいユーザー名をパラメータとして設定
$targetUserName = "Charlie"
$command.Parameters.AddWithValue("@targetUserName", $targetUserName)

Write-Host "$($targetUserName) のユーザー情報を取得します..."
$reader = $command.ExecuteReader()

if ($reader.HasRows) {
    Write-Host "取得したデータ:"
    while ($reader.Read()) {
        $userId = $reader["UserId"]
        $userName = $reader["UserName"]
        $email = $reader["Email"]
        Write-Host "  UserId: $userId, UserName: $userName, Email: $email"
    }
}
else {
    Write-Host "$($targetUserName) というユーザーは存在しません。"
}

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($reader -is [System.IDisposable]) {
$reader.Dispose()
}
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

WHERE UserName = @targetUserNameのようにパラメータを使用し、$command.Parameters.AddWithValue("@targetUserName", $targetUserName)で値を渡しています。これにより、変数$targetUserNameの値にシングルクォーテーションやその他のSQL特殊文字が含まれていても、正しくデータとして扱われます。

6.3 様々なデータ型とパラメータ

AddWithValue()は多くの基本的なデータ型（文字列、整数、真偽値など）を自動的に処理してくれますが、NULL値や日付/時刻、バイナリデータなど、特定のデータ型を扱う場合は、SqliteParameterオブジェクトを明示的に作成し、DbTypeプロパティを設定してからAdd()メソッドで追加する方がより厳密で安全です。

例 6.3.1: NULL値を含むデータの挿入

メールアドレスが不明なユーザーを挿入する場合、NULL値を格納します。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

$sqlInsert = @"

INSERT INTO Users (UserName, Email) VALUES (@userName, @email);
“@
$command.CommandText = $sqlInsert

# NULL値を設定する場合
$command.Parameters.AddWithValue("@userName", "Eve")
# [System.DBNull]::Value を使用してNULL値を指定
$command.Parameters.AddWithValue("@email", [System.DBNull]::Value)

Write-Host "データを挿入します (Eve, EmailはNULL)..."
$rowsAffected = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected) 行が挿入されました。"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
}
}
“`

データベースのNULL値はPowerShellの$nullとは異なります。ADO.NETでデータベースのNULL値を扱う場合は、静的なプロパティ[System.DBNull]::Valueを使用します。

注意点: SQLiteは非常に柔軟な型システムを持っていますが、ADO.NETプロバイダはより厳格な型マッピングを行います。パラメータのDbTypeを明示的に指定することで、意図した型でのデータ格納を保証できます。利用可能なDbTypeは[System.Data.DbType]列挙型で確認できます。SQLiteの型アフィニティ（INTEGER, TEXT, BLOB, REAL, NUMERIC）とADO.NETのDbTypeのマッピングについては、Microsoft.Data.Sqliteのドキュメントを参照してください。

パラメータの使用は、PowerShellでSQLiteを安全かつ効率的に扱うための最も重要なテクニックの一つです。常にパラメータを使用する習慣をつけましょう。

第7章: トランザクション処理

複数のデータベース操作（例えば、複数のレコードの挿入、更新、削除）をまとめて実行し、それら全体として一つの論理的な処理単位として扱いたい場合があります。このような場合に「トランザクション (Transaction)」を使用します。

トランザクションは、データベース操作のACID特性を保証します。

Atomicity (原子性): トランザクション内のすべての操作は成功するか、すべて失敗するかのどちらかです。途中でエラーが発生した場合、それまでに行われたすべての変更は元に戻されます（ロールバックされます）。
Consistency (一貫性): トランザクションの開始前と完了後で、データベースは一貫性のある状態を保ちます。
Isolation (独立性): 複数のトランザクションが同時に実行されても、それぞれが他のトランザクションの影響を受けずに独立して実行されているように見えます。
Durability (永続性): 成功したトランザクションによる変更は永続的であり、システム障害（電源喪失など）が発生しても失われません。

トランザクションを使用しない場合、各SQLコマンドは個別のトランザクションとして自動的に実行されます。これは単純な操作には問題ありませんが、例えば「Aテーブルからレコードを削除し、その内容をBテーブルに挿入する」のような一連の操作で、削除は成功したが挿入が失敗した場合、データの一貫性が失われてしまいます。トランザクション内でこれらの操作を実行すれば、挿入が失敗した場合に削除もロールバックされ、データベースは操作開始前の状態に戻ります。

PowerShellでSQLiteのトランザクションを扱うには、SqliteConnectionオブジェクトのBeginTransaction()メソッドを使用します。このメソッドはMicrosoft.Data.Sqlite.SqliteTransactionオブジェクトを返します。コマンドを実行する際には、そのコマンドがどのトランザクションの一部であるかを$command.Transactionプロパティで指定します。トランザクション内のすべての操作が成功したら$transaction.Commit()を呼び出し、途中でエラーが発生した場合は$transaction.Rollback()を呼び出します。

7.1 トランザクションの使用方法

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null
$transaction = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()
Write-Host “データベース接続に成功しました。”

# --- トランザクションを開始 ---
Write-Host "トランザクションを開始します。"
$transaction = $connection.BeginTransaction()

# コマンドオブジェクトを作成し、トランザクションと関連付ける
$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection
$command.Transaction = $transaction # **重要: トランザクションオブジェクトを指定**

# --- トランザクション内の操作 ---

# 操作 1: ユーザーを挿入
$sqlInsert1 = "INSERT INTO Users (UserName, Email) VALUES (@user1Name, @user1Email);"
$command.CommandText = $sqlInsert1
$command.Parameters.Clear() # パラメータをクリア
$command.Parameters.AddWithValue("@user1Name", "Frank")
$command.Parameters.AddWithValue("@user1Email", "[email protected]")
Write-Host "最初のユーザーを挿入します..."
$rowsAffected1 = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected1) 行が挿入されました (Frank)。"

# 操作 2: 別のユーザーを挿入
$sqlInsert2 = "INSERT INTO Users (UserName, Email) VALUES (@user2Name, @user2Email);"
$command.CommandText = $sqlInsert2
$command.Parameters.Clear() # パラメータをクリア
$command.Parameters.AddWithValue("@user2Name", "Grace")
# ※ ここで意図的にエラーを引き起こす例 (例: EmailカラムをNOT NULLにし、@user2EmailをNULLにするなど)
# 例として、ここではエラーを発生させずに正常に進むものとします。
$command.Parameters.AddWithValue("@user2Email", "[email protected]")
Write-Host "二番目のユーザーを挿入します..."
$rowsAffected2 = $command.ExecuteNonQuery()
Write-Host "$($rowsAffected2) 行が挿入されました (Grace)。"

# --- すべての操作が成功した場合 ---
Write-Host "トランザクションをコミットします。"
$transaction.Commit()
Write-Host "トランザクションが正常に完了しました。"

}
catch {
Write-Error “エラーが発生しました: $($_.Exception.Message)”

# --- エラーが発生した場合、トランザクションをロールバック ---
if ($transaction) {
    Write-Host "トランザクションをロールバックします。"
    try {
        $transaction.Rollback()
        Write-Host "トランザクションがロールバックされました。"
    }
    catch {
        Write-Error "トランザクションのロールバック中にエラーが発生しました: $($_.Exception.Message)"
    }
}

}
finally {
# トランザクションオブジェクトもIDisposableなので破棄
if ($transaction -is [System.IDisposable]) {
$transaction.Dispose()
$transaction = $null
Write-Host “トランザクションオブジェクトを破棄しました。”
}
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
$connection = $null
Write-Host “Connectionオブジェクトを破棄しました。”
}
}
“`

このスクリプトでは、$connection.BeginTransaction()でトランザクションを開始し、取得した$transactionオブジェクトを各$command.Transactionプロパティに設定しています。トランザクションが開始されると、そのトランザクションを指定したコマンドによる変更は、コミットされるまでデータベースファイルに永続的には書き込まれません（他の接続からは見えない場合や、ジャーナルファイルに一時的に書き込まれる場合があります）。

tryブロックの最後に達したら、$transaction.Commit()を呼び出し、トランザクション内のすべての変更を確定させてデータベースに永続化します。

catchブロックに入った場合（つまり、トランザクション内のいずれかの操作でエラーが発生した場合）、$transaction.Rollback()を呼び出します。これにより、トランザクション開始以降に行われたすべての変更が取り消され、データベースはトランザクション開始前の状態に戻ります。

finallyブロックでは、$transactionオブジェクトと$connectionオブジェクトの両方を適切に破棄しています。SqliteTransactionオブジェクトもIDisposableを実装しているため、リソース解放が必要です。

トランザクションは、複数の関連するデータベース操作の整合性を保つために非常に重要です。特に、データの追加、更新、削除が組み合わさるような処理では積極的に使用することを検討してください。

第8章: エラーハンドリング

データベース操作においては、様々なエラーが発生する可能性があります。

データベースファイルが見つからない、アクセス権がない
SQLステートメントの構文エラー
制約違反（例: UNIQUE制約のあるカラムに重複した値を挿入しようとする、NOT NULLカラムにNULLを挿入しようとする）
接続が切断される
トランザクション中のデッドロック（SQLiteではあまり一般的ではないが、可能性はある）

これらのエラーを適切に処理しないと、スクリプトが予期せず終了したり、データベースが不整合な状態になったりする可能性があります。PowerShellでは、try/catch/finallyブロックを使用してデータベース操作のエラーハンドリングを行うのが標準的な方法です。

8.1 `try/catch/finally`ブロックの使用

前の章までの例でも見てきたように、tryブロックの中にエラーが発生する可能性のあるコードを記述し、catchブロックでエラーを捕捉して処理を記述します。finallyブロックは、エラーの発生有無にかかわらず必ず実行されるため、データベース接続やデータリーダー、トランザクションなどのリソース解放を記述するのに最適です。

“`powershell

データベースファイルのパス (例: 存在しないパスや読み取り権限がないパスを指定してエラーを発生させる)

$dbPath = “C:\NonExistentFolder\MyDatabase.db”

$connectionString = “Data Source=$dbPath”

または、SQL構文エラーを発生させる

$sqlError = “SELECT FROM Users;” # FROMの後にカラム名がない

$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”
$connection = $null

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
Write-Host “接続を開こうとしています…”
$connection.Open() # ここでファイルアクセスエラーなどが発生する可能性
Write-Host “データベース接続に成功しました。”

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand()
$command.Connection = $connection

# 例: 意図的にSQL構文エラーを起こす
$sql = "SELECT * FRM Users;" # FROMを間違えている
# $sql = "SELECT * FROM NonExistentTable;" # 存在しないテーブルを参照
$command.CommandText = $sql

Write-Host "SQLコマンドを実行しようとしています..."
# $reader = $command.ExecuteReader() # ここでSQL実行エラーが発生する可能性
# 例として ExecuteNonQuery を使用
$command.ExecuteNonQuery()

Write-Host "SQLコマンドが正常に実行されました (これは表示されないはず)"

}
catch {
# エラーオブジェクトは自動変数 $ に格納される
Write-Error “データベース操作中にエラーが発生しました。”
Write-Error “エラータイプ: $($.Exception.GetType().FullName)”
Write-Error “エラーメッセージ: $($_.Exception.Message)”

# 特定のエラータイプをハンドリングすることも可能
# 例えば、System.Data.SQLite.SqliteException を捕捉するなど
# if ($_.Exception -is [Microsoft.Data.Sqlite.SqliteException]) {
#     Write-Error "SQLite固有のエラーが発生しました。"
#     Write-Error "SQLiteエラーコード: $($_.Exception.SqliteErrorCode)"
#     Write-Error "SQLite拡張エラーコード: $($_.Exception.SqliteExtendedErrorCode)"
# }
# else {
#     Write-Error "その他のエラーが発生しました。"
# }

}
finally {
Write-Host “Finallyブロックを実行します。”
# リソース解放処理
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
Write-Host “Connectionオブジェクトを破棄しました。”
}
}
“`

catchブロック内で、自動変数$_を通じてエラーオブジェクトにアクセスできます。$_.Exceptionは、発生した例外に関する情報（タイプ、メッセージ、スタックトレースなど）を提供します。Microsoft.Data.Sqliteを使用している場合、データベース固有のエラーはMicrosoft.Data.Sqlite.SqliteExceptionとして捕捉できる場合があります。この例外オブジェクトは、SQLiteのエラーコードなどの追加情報を持っていることがあります（ただし、Microsoft.Data.SqliteはSystem.Data.SQLiteほど詳細なSQLite固有のエラー情報を提供しない場合があります。基本的にはMessageとInnerExceptionを確認します）。

トランザクションを使用している場合は、catchブロック内で$transaction.Rollback()を呼び出すことを忘れないようにします。

堅牢なスクリプトを作成するためには、起こりうるエラーを想定し、適切にエラーハンドリングを実装することが不可欠です。

第9章: SQLiteデータ型とPowerShell/.NETの型のマッピング

SQLiteは独自の「型アフィニティ (Type Affinity)」システムを持っています。これは、他の多くのデータベースシステムのような厳密な静的型付けとは少し異なります。SQLiteのカラムの型は、格納されるべきデータの種類を推奨するものであり、その型のデータのみを格納できるわけではありません。どのような型のデータでも、基本的には以下の5つの「ストレージクラス (Storage Class)」のいずれかで格納されます。

NULL: 値がNULLである。
INTEGER: 符号付き整数。1, 2, 3, 4, 6, または8バイトで格納される。
REAL: 浮動小数点数。8バイトのIEEE浮動小数点数で格納される。
TEXT: 文字列。UTF-8, UTF-16BE, またはUTF-16LEエンコーディングで格納される。
BLOB: バイナリデータ。入力された通りの生データとして格納される。

カラムを宣言する際に指定する型名（例: INT, VARCHAR, DOUBLE, BOOLEANなど）は、SQLiteがそのカラムに対してどの「型アフィニティ」を適用するかを決定するために使用されます。例えば、INT, INTEGER, BIGINTなどはINTEGERアフィニティを持ちます。VARCHAR, TEXT, CLOBなどはTEXTアフィニティを持ちます。

一方、PowerShellや.NETでは、[int], [string], [double], [datetime], [byte[]]といった厳密な型があります。PowerShellからSQLiteを操作するADO.NETプロバイダ（Microsoft.Data.Sqlite）は、これらの.NETの型とSQLiteのストレージクラスの間で適切な変換を行います。

9.1 一般的な型のマッピング

Microsoft.Data.Sqliteを使用する場合、一般的な型のマッピングは以下のようになります。

.NET/PowerShell 型	`DbType` (Add()で使用)	SQLite 型アフィニティ	SQLite ストレージクラス
`[string]`	`String`	TEXT	TEXT
`[int]`	`Int32`	INTEGER	INTEGER
`[long]`	`Int64`	INTEGER	INTEGER
`[bool]`	`Boolean`	INTEGER	INTEGER (0 or 1)
`[double]`	`Double`	REAL	REAL
`[decimal]`	`Decimal`	NUMERIC	NUMERIC/REAL
`[datetime]`	`DateTime`	TEXT または REAL	TEXT (ISO 8601) または REAL (Unixタイムスタンプ)
`[byte[]]`	`Binary`	BLOB	BLOB
`[System.DBNull]::Value`	`DbNull`	N/A	NULL

日付/時刻 ([datetime]) の扱い:
SQLiteには組み込みの日付/時刻型がありません。通常、日付/時刻データはTEXT (ISO 8601形式の文字列)、REAL (Unixタイムスタンプ形式の浮動小数点数)、またはINTEGER (Unixタイムスタンプ形式の整数) として格納されます。Microsoft.Data.Sqliteは、デフォルトでTEXT形式（ISO 8601）との間で[datetime]型の変換を行います。他の形式で格納したい場合は、接続文字列にDateTimeFormatオプションを指定するか、SqliteParameterのDbTypeとValueを適切に設定する必要があります。ISO 8601形式が最も一般的で推奨されます。

真偽値 ([bool]) の扱い:
SQLiteに組み込みの真偽値型はありません。通常、真偽値はINTEGER型で、0をFalse、1をTrueとして格納します。Microsoft.Data.Sqliteは、[bool]型とINTEGERストレージクラスの間で自動的にこの変換を行います。

9.2 データリーダーからのデータ取得時の型変換

ExecuteReader()から取得したSqliteDataReaderを使ってデータを読み込む際、$reader["ColumnName"]や$reader.GetValue(index)で取得される値はデフォルトでobject型です。PowerShellは通常、このobject型を適切な型に自動変換してくれますが、明示的にキャストすることで意図しない型変換を防ぐことができます。

“`powershell

DataReaderから値を取得

$userIdObject = $reader[“UserId”]
$userNameObject = $reader[“UserName”]
$emailObject = $reader[“Email”]

明示的に型キャストする

$userId = [int]$userIdObject
$userName = [string]$userNameObject

EmailがNULLの場合もあるため、string? はPowerShellに無いので注意

Nullableな型を扱う場合は、DBNullチェックが必要

if ($emailObject -ne [System.DBNull]::Value) {
$email = [string]$emailObject
} else {
$email = $null
}

または、Null許容型に対応したメソッドを使用 (ADO.NETの機能)

$email = $reader.GetFieldValuestring? # C#/.NETなら可能だが、PowerShellでは少し難しい場合がある

PowerShellではDBNullチェックが最も確実

if ($reader.IsDBNull(2)) { # 2はEmailカラムのインデックス
$email = $null
} else {
$email = $reader.GetString(2) # GetStringなどの型別取得メソッドもある
}

Write-Host “UserId: $($userId.GetType().Name), UserName: $($userName.GetType().Name), Email: $(if($email -ne $null){$email.GetType().Name}else{“NULL”})”
“`

SqliteDataReaderクラスには、GetInt32(), GetString(), GetDouble(), GetBoolean(), IsDBNull()など、特定の型の値を取得したり、値がNULLかどうかをチェックしたりするためのメソッドが用意されています。これらのメソッドを適切に使うことで、より安全かつ意図した型でデータを取得できます。

$reader.IsDBNull(columnIndex): 指定した列の値がNULLかどうかを返す。
$reader.GetInt32(columnIndex): 指定した列の値を32ビット整数として取得する。
$reader.GetString(columnIndex): 指定した列の値を文字列として取得する。
$reader.GetDouble(columnIndex): 指定した列の値を倍精度浮動小数点数として取得する。
$reader.GetBoolean(columnIndex): 指定した列の値を真偽値として取得する（SQLiteの0/1から変換）。

これらの型別取得メソッドを使用する方が、GetValue()やインデクサーアクセスからの自動変換や明示的キャストよりも推奨される場合があります。特にNULL値の扱いや厳密な型変換が必要な場合に有効です。

第10章: 実践的な例

これまでに学んだ基本的な要素（接続、コマンド、パラメータ、リーダー、トランザクション）を組み合わせて、より実践的な例をいくつか見ていきましょう。

10.1 CSVファイルからのデータインポート

PowerShellでよく行う作業の一つに、CSVファイルなどの外部データソースからデータを読み込み、処理することがあります。SQLiteデータベースは、このようなデータを構造的に保存するのに非常に適しています。

ここでは、簡単なCSVファイルを読み込み、その内容をSQLiteデータベースのテーブルにインポートするスクリプトの基本的な構造を示します。

対象CSV (users.csv):
csv UserName,Email Alice,[email protected] Bob,[email protected] Charlie,[email protected]

スクリプト例:
“`powershell

CSVファイルのパス

$csvFilePath = “.\users.csv” # スクリプトと同じディレクトリにあると仮定

データベースファイルのパス

$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”

$connection = $null
$transaction = $null

try {
# データベースに接続
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()
Write-Host “データベース接続に成功しました。”

# テーブルが存在しない場合は作成 (例 5.1.1 と同じCREATE TABLE文を使用)
$createTableSql = @"

CREATE TABLE IF NOT EXISTS Users (
UserId INTEGER PRIMARY KEY AUTOINCREMENT,
UserName TEXT NOT NULL UNIQUE,
Email TEXT
);
“@
$command = New-Object Microsoft.Data.Sqlite.SqliteCommand($createTableSql, $connection)
$command.ExecuteNonQuery()
Write-Host “Users テーブルが存在することを確認 (または作成) しました。”

# CSVファイルを読み込む
Write-Host "CSVファイルを読み込みます: $($csvFilePath)"
$csvData = Import-Csv -Path $csvFilePath

# --- データインポートをトランザクション内で行う ---
Write-Host "インポートトランザクションを開始します。"
$transaction = $connection.BeginTransaction()

# 挿入コマンドを準備 (パラメータを使用)
$insertSql = "INSERT INTO Users (UserName, Email) VALUES (@userName, @email);"
$command = New-Object Microsoft.Data.Sqlite.SqliteCommand($insertSql, $connection, $transaction)
# パラメータを事前に定義 (AddWithValue()はループ内で値だけ変更)
$command.Parameters.Add("@userName", [System.Data.DbType]::String) | Out-Null
$command.Parameters.Add("@email", [System.Data.DbType]::String) | Out-Null

Write-Host "データをデータベースにインポートします..."
$importedCount = 0

# CSVデータの各行をループして挿入
foreach ($row in $csvData) {
    try {
        # パラメータに現在の行の値を設定
        $command.Parameters["@userName"].Value = $row.UserName
        $command.Parameters["@email"].Value = $row.Email

        # 挿入を実行
        $command.ExecuteNonQuery()
        $importedCount++
    }
    catch {
        # 特定のエラー（例: UNIQUE制約違反）をスキップすることも可能
        if ($_.Exception -is [Microsoft.Data.Sqlite.SqliteException] -and $_.Exception.Message -like '*UNIQUE constraint failed*') {
             Write-Warning "UNIQUE制約違反のため、ユーザー $($row.UserName) の挿入をスキップしました。"
        }
        else {
             # その他のエラーは再スローしてトランザクションをロールバックさせる
             Write-Error "ユーザー $($row.UserName) の挿入中にエラーが発生しました: $($_.Exception.Message)"
             throw # エラーを再スローしてcatchブロックの外に伝える
        }
    }
}

# すべての行の処理が成功した場合のみコミット
Write-Host "インポートが完了しました。コミットします。"
$transaction.Commit()
Write-Host "$($importedCount) 行が正常にインポートされました。"

}
catch {
Write-Error “インポート処理中にエラーが発生しました: $($_.Exception.Message)”

# エラー発生時はロールバック
if ($transaction) {
    Write-Host "トランザクションをロールバックします。"
    try {
        $transaction.Rollback()
        Write-Host "トランザクションがロールバックされました。"
    }
    catch {
        Write-Error "ロールバック中にエラーが発生しました: $($_.Exception.Message)"
    }
}

}
finally {
# リソース解放
if ($transaction -is [System.IDisposable]) {
$transaction.Dispose()
$transaction = $null
}
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
$connection = $null
}
Write-Host “リソースを解放しました。”
}
“`

この例では、Import-CsvでCSVファイルを読み込み、取得した各行（オブジェクト）をループ処理しています。ループの中で、パラメータを設定したINSERTコマンドを実行しています。インポート処理全体をトランザクションで囲むことで、CSVの途中に不正なデータがあっても（ここではUNIQUE制約違反を例にエラーハンドリングしていますが）、エラーが発生した場合にはそれまでの挿入も含めてすべてロールバックし、データベースの整合性を保つことができます。

10.2 データの取得とPowerShellオブジェクトへの変換

データベースから取得したデータを、PowerShellのカスタムオブジェクトの配列として取得したい場合が多くあります。これにより、取得したデータをパイプラインで他のコマンドレット（例: Where-Object, Sort-Object, Export-Csv, ConvertTo-Jsonなど）に渡してさらに処理することが容易になります。

“`powershell
$dbPath = “C:\temp\MyPowerShellDatabase.db”
$connectionString = “Data Source=$dbPath”

$connection = $null
$reader = $null
$userData = @() # 結果を格納する配列

try {
$connection = New-Object Microsoft.Data.Sqlite.SqliteConnection($connectionString)
$connection.Open()
Write-Host “データベース接続に成功しました。”

$command = New-Object Microsoft.Data.Sqlite.SqliteCommand("SELECT UserId, UserName, Email FROM Users;", $connection)

Write-Host "ユーザーデータを取得します..."
$reader = $command.ExecuteReader()

if ($reader.HasRows) {
    # 結果セットの各行を読み込み、PowerShellオブジェクトに変換
    while ($reader.Read()) {
        # 各列の値を取得 (DBNullチェックを推奨)
        $userId = $reader.GetInt32(0)
        $userName = $reader.GetString(1)
        # EmailはNULLの可能性があるのでDBNullチェック
        $email = if ($reader.IsDBNull(2)) { $null } else { $reader.GetString(2) }

        # カスタムオブジェクトを作成
        $userObject = [PSCustomObject]@{
            UserId   = $userId
            UserName = $userName
            Email    = $email
        }

        # 配列に追加
        $userData += $userObject
    }
    Write-Host "データ取得完了。$($userData.Count) 件のレコードをオブジェクトに変換しました。"
}
else {
    Write-Host "データは存在しません。"
}

# 取得したオブジェクト配列を操作 (例: 表示)
Write-Host "`n取得したオブジェクトデータ:"
$userData | Format-Table

# 例: 条件で絞り込む
# $userData | Where-Object UserName -like "A*" | Format-List

# 例: CSVとしてエクスポート
# $userData | Export-Csv -Path ".\users_export.csv" -NoTypeInformation

}
catch {
Write-Error “データ取得中にエラーが発生しました: $($_.Exception.Message)”
}
finally {
if ($reader -is [System.IDisposable]) {
$reader.Dispose()
$reader = $null
}
if ($connection -is [System.IDisposable]) {
$connection.Dispose()
$connection = $null
}
Write-Host “リソースを解放しました。”
}
“`

このスクリプトでは、SqliteDataReaderから取得した各行のデータを使って、[PSCustomObject]でカスタムオブジェクトを作成しています。列の値を取得する際には、IsDBNull()でNULLチェックを行い、必要に応じてGetInt32(), GetString()などの型別取得メソッドを使用しています。これにより、データベースのデータをPowerShellの強力なオブジェクト処理パイプラインに乗せることができます。

第11章: より高度なトピック

SQLiteとPowerShellの連携をさらに活用するために、いくつかより高度なトピックに触れておきます。

11.1 JOINを使った複数テーブルからのデータ取得

リレーショナルデータベースの重要な機能の一つに、複数のテーブルを結合して関連するデータを一度に取得するJOINがあります。例えば、ユーザーテーブルと注文テーブルがある場合に、「各ユーザーの注文履歴」を取得する、といったことが可能です。

SQLiteは標準的なSQL JOIN構文をサポートしています。

sql -- 例: Orders テーブルがあると仮定 (UserId, OrderDate, Amount) -- Users テーブルと Orders テーブルを UserId で結合し、各ユーザーとその注文数を取得 SELECT U.UserName, COUNT(O.UserId) AS OrderCount FROM Users AS U LEFT JOIN Orders AS O ON U.UserId = O.UserId GROUP BY U.UserName ORDER BY U.UserName;

このSQLステートメントをPowerShellから実行するには、これまで説明したExecuteReader()と同じ方法を使用します。

“`powershell

データベース接続とコマンドオブジェクトの準備 (省略)

…

$sqlJoin = @”
SELECT
U.UserName,
COUNT(O.UserId) AS OrderCount
FROM Users AS U
LEFT JOIN Orders AS O ON U.UserId = O.UserId
GROUP BY U.UserName
ORDER BY U.UserName;
“@

$command.CommandText = $sqlJoin

Write-Host “ユーザーと注文数を取得します…”
$reader = $command.ExecuteReader()

結果の処理 (省略 – 例 10.2 と同様に DataReader から読み込む)

…

“`

JOINは複雑なデータ構造を持つデータベースから、必要な情報を効率的に取得するために不可欠なテクニックです。

11.2 インデックスの利用

データベースの規模が大きくなり、テーブルに格納されるレコードが増えてくると、SELECTクエリのパフォーマンスが問題になることがあります。特に、WHERE句やJOIN句で頻繁に使用されるカラムに対しては、インデックス (Index) を作成することで検索速度を大幅に向上させることができます。

インデックスは、テーブルの特定のカラムの値と、その値を持つレコードの物理的な位置を関連付けたデータ構造です。本の索引のようなものと考えれば分かりやすいでしょう。インデックスがあることで、データベースはテーブル全体をスキャンすることなく、素早く目的のレコードを見つけることができます。

ただし、インデックスを作成すると、データの挿入、更新、削除の際にインデックス自体も更新する必要があるため、これらの操作のパフォーマンスは若干低下します。したがって、インデックスは検索操作が頻繁に行われるカラムに対してのみ作成するのが一般的です。

インデックスの作成はCREATE INDEXステートメントを使用します。

“`sql
— UserName カラムにインデックスを作成
CREATE INDEX IX_Users_UserName ON Users (UserName);

— 複数のカラムにインデックスを作成 (複合インデックス)
— CREATE INDEX IX_Users_Email_UserName ON Users (Email, UserName);
“`

インデックスの作成もExecuteNonQuery()を使用してPowerShellから実行できます。

“`powershell

データベース接続とコマンドオブジェクトの準備 (省略)

…

$sqlIndex = “CREATE INDEX IF NOT EXISTS IX_Users_UserName ON Users (UserName);”

$command.CommandText = $sqlIndex
Write-Host “UserName カラムにインデックスを作成します…”
$command.ExecuteNonQuery()
Write-Host “インデックス作成コマンドが実行されました。”
“`

インデックスの設計はデータベースパフォーマンスチューニングの重要な側面です。どのカラムにインデックスを作成すべきかは、アプリケーションのクエリパターンによって異なります。

11.3 BULK INSERT (大量データ挿入)

CSVインポートの例で各行をループして個別にINSERTステートメントを実行しましたが、インポートするデータ量が非常に多い場合（数万行、数百万行）、この方法は非効率的になることがあります。個々の挿入ごとにデータベースとのやり取りやトランザクションのオーバーヘッドが発生するためです。

SQLiteで大量のデータを高速に挿入するには、以下の方法があります。

単一のトランザクション内で複数のINSERTステートメントを実行: これは例 10.1 で行った方法です。個々のINSERTは速くなくても、トランザクションを一つにまとめることでオーバーヘッドを減らせます。
複数行INSERTステートメント: 1つのINSERTステートメントで複数の行をまとめて挿入します。
sql INSERT INTO Users (UserName, Email) VALUES ('Frank', '[email protected]'), ('Grace', '[email protected]'), ('Heidi', '[email protected]');
PowerShellでこれを動的に構築するには、CSVデータの各行からVALUES句の部分を文字列として組み立てる必要があります。これは文字列操作が複雑になる場合がありますが、個別のINSERTよりも効率的です。パラメータと組み合わせることも可能です。
特別なバルクローディング機能: ADO.NETにはSqlBulkCopyのようなバルクコピー機能を提供するプロバイダもありますが、Microsoft.Data.Sqliteでは標準では直接サポートされていません（SQL Serverプロバイダなどにある機能です）。しかし、トランザクション内で上記1または2の方法を組み合わせるのが最も一般的な大量挿入方法です。

大量データ挿入のパフォーマンスは、トランザクションの使用、SQLステートメントの効率性、インデックスの有無など、複数の要因に依存します。

第12章: パフォーマンスの考慮事項

PowerShellからSQLiteを扱う際に、パフォーマンスを最大化するためのいくつかの考慮事項があります。

トランザクションの使用: 大量の書き込み操作（INSERT, UPDATE, DELETE）を行う場合は、必ずトランザクションを使用し、すべての操作を単一のトランザクションに含めます。これにより、ディスクへの書き込み回数が大幅に削減され、パフォーマンスが向上します。個々の書き込み操作は自動的にトランザクションになりますが、それぞれの自動トランザクションが完了するたびにディスクへの同期書き込み（同期モードに依存）が発生し、遅くなります。
同期モード: SQLiteの同期モード (PRAGMA synchronous) は、データベースの書き込みがディスクに物理的に書き込まれるタイミングを制御します。デフォルトはFULLで、これはクラッシュからの回復性を最も高くしますが、最も遅いです。パフォーマンスが最優先で、もしものクラッシュ時のデータ損失がある程度許容できる場合は、NORMALやOFFに変更することを検討できます。これは接続文字列にSynchronous=Normal;のように指定するか、PRAGMA synchronous = NORMAL;のようなSQLコマンドを実行して変更できます。ただし、OFFはデータ破損のリスクを高めるため、慎重に使用してください。
ジャーナルモード: SQLiteはトランザクションの原子性を確保するためにジャーナルファイルを使用します。デフォルトはDELETEですが、WAL (Write-Ahead Logging) モードの方が多くのシナリオで並行性と書き込みパフォーマンスが向上する可能性があります。PRAGMA journal_mode = WAL;コマンドで変更できます。
インデックス: 検索性能が必要なカラムに適切にインデックスを作成します。ただし、書き込み性能には負の影響があるため、バランスが重要です。
パラメータ化クエリ: パラメータを使用することで、特に繰り返し実行されるクエリにおいて、データベース側がクエリプランをキャッシュしやすくなり、パフォーマンスが向上する可能性があります。
DataReaderの効率的な利用: ExecuteReader()でデータを取得する場合、while ($reader.Read())ループ内で各列の値に効率的にアクセスします。可能であれば、GetInt32(), GetString()などの型別取得メソッドを使用します。必要のない列はSELECTステートメントで指定しないようにします。
接続の管理: 必要になったら接続を開き、操作が完了したらすぐに閉じます。多数の接続を長時間開きっぱなしにすると、リソースを消費し、他のプロセスからのファイルアクセスを妨げる可能性があります。

これらの考慮事項は、特に大量データを扱うスクリプトや、頻繁にデータベース操作を行うスクリプトにおいて重要になります。

第13章: よくある落とし穴とデバッグ

PowerShellでSQLiteを扱う際によく遭遇する問題と、そのデバッグ方法について説明します。

データベース接続が閉じられていない: これは最も一般的な問題の一つです。接続、DataReader、TransactionといったIDisposableオブジェクトは、使用後に必ずDispose()メソッドを呼び出すか、try/finallyブロックを使用してリソース解放を保証する必要があります。リソースリークの原因となり、データベースファイルがロックされて他のプロセスからアクセスできなくなることがあります。
SQL構文エラー: SQLステートメントの記述ミスは、特に複雑なクエリや初めて使う構文で発生しがちです。catchブロックで$_.Exception.Messageを確認すると、SQLiteからのエラーメッセージが表示されるため、SQL構文のどこが間違っているか特定できます。必要であれば、SQLiteのGUIツール（DB Browser for SQLiteなど）で同じSQLを実行して確認するのも有効です。
ファイルアクセス権の問題: データベースファイルやそのディレクトリに対する読み書き権限がない場合、接続を開くときやコマンドを実行するときにエラーが発生します。スクリプトを実行しているユーザーに必要なファイル権限があるか確認してください。
パラメータの不一致: SQLステートメントのパラメータプレースホルダと、$command.Parametersコレクションに追加したパラメータの数や名前が一致しない場合にエラーが発生します。特に名前付きパラメータ（@parametername）を使用している場合は、名前のスペルミスがないか確認してください。
データ型の不一致: パラメータに渡す値の型と、データベースカラムの型アフィニティが大きく異なる場合や、DataReaderから取得した値を不適切な型として扱おうとした場合にエラーが発生することがあります。AddWithValueの自動型変換に頼りすぎず、必要に応じてSqliteParameterでDbTypeを明示的に指定したり、DataReaderの型別取得メソッド（GetInt32, GetStringなど）を使用したりすることを検討してください。NULL値を扱う場合は[System.DBNull]::ValueとIsDBNull()を正しく使用することが重要です。
モジュール/アセンブリがロードされていない: Microsoft.Data.Sqlite.Toolsモジュールをインポートしていない場合、New-Object Microsoft.Data.Sqlite.SqliteConnectionなどのクラスが見つからないというエラーが発生します。Import-Module Microsoft.Data.Sqlite.Toolsがスクリプトの冒頭で実行されているか確認してください。
トランザクションがコミットまたはロールバックされていない: トランザクションを開始したにもかかわらず、コミットもロールバックもせずに接続を閉じた場合、トランザクションは自動的にロールバックされます（これは通常期待される動作ですが、意図しないデータの消失につながる可能性があります）。トランザクションを使用する場合は、try/catch/finallyでコミットとロールバックの処理を適切に記述してください。

デバッグの際には、Write-Hostを使って変数の値（特に接続文字列、SQLステートメント、パラメータの値）や実行の流れ（どのブロックに入ったか、どの操作をしようとしているかなど）を出力させると、問題の箇所を特定しやすくなります。$_.Exception.Messageに表示されるエラーメッセージを注意深く読むことが最も重要です。

第14章: まとめと次のステップ

この記事では、PowerShellからSQLiteデータベースを扱うための基本的な技術について、詳細に解説しました。

SQLiteの基本的な特徴と、PowerShellと組み合わせるメリットを理解しました。
Microsoft.Data.Sqlite.Toolsモジュールを使った環境構築方法を学びました。
SqliteConnectionクラスを使ったデータベースへの接続確立と切断の方法、およびリソース解放の重要性を理解しました。
SqliteCommandクラスを使用し、ExecuteNonQuery()、ExecuteReader()、ExecuteScalar()メソッドを使って様々なSQLコマンドを実行する方法を学びました。
セキュリティと堅牢性のためにパラメータを使用する重要性と具体的な方法を理解しました。
SqliteTransactionクラスを使ったトランザクション処理の基本と、ACID特性の重要性を理解しました。
try/catch/finallyブロックを使ったエラーハンドリングの方法を学びました。
SQLiteの型アフィニティとPowerShell/.NETの型のマッピングについて理解しました。
CSVインポートやデータ取得とPowerShellオブジェクトへの変換といった実践的な例を見ました。
JOIN、インデックス、バルクインサート、パフォーマンス考慮事項、よくある落とし穴といった高度なトピックにも触れました。

これらの基本的な知識とテクニックを習得すれば、PowerShellスクリプトでSQLiteをデータストアとして活用するための強力な基盤が得られます。

次のステップとして、以下のことを試してみることをお勧めします。

この記事で学んだコード例を実際に自分で書いて実行し、動作を確認する。
自分のPowerShellスクリプトで、設定情報の保存や簡単なログ記録にSQLiteを使ってみる。
より複雑なSQLクエリ（サブクエリ、ウィンドウ関数など）をSQLiteで実行し、PowerShellで結果を処理してみる。
PowerShellの他のコマンドレット（例: Invoke-WebRequestで取得したWebデータ、イベントログなど）からデータを取得し、SQLiteデータベースに格納・分析してみる。
SQLiteの公式ドキュメントやMicrosoft.Data.Sqliteのドキュメントを参照し、さらに詳しい機能（ユーザー定義関数、トリガーなど）や高度な使い方について学ぶ。
DB Browser for SQLiteのようなGUIツールを使って、PowerShellスクリプトで作成・操作したデータベースファイルの内容を直接確認してみる。

PowerShellとSQLiteは、どちらも単体でも非常に強力ですが、組み合わせることでスクリプトや自動化ツールの可能性を大きく広げることができます。この記事が、その旅の良いスタートとなることを願っています。

PowerShellでSQLiteデータベースを扱う基本：詳細解説

はじめに

第1章: SQLiteの基本

1.1 SQLiteとは？

1.2 SQLiteの主な特徴

1.3 SQLiteの用途

第2章: なぜPowerShellとSQLiteなのか

2.1 PowerShellのデータ処理能力

2.2 データ永続化の課題とデータベースの利点

2.3 PowerShellとSQLiteの組み合わせのメリット

第3章: 環境構築

3.1 Microsoft.Data.Sqlite モジュールのインストール

現在のユーザーにインストールする場合 (管理者権限不要だが、モジュールパスに注意)

全ユーザーにインストールする場合 (管理者権限が必要)

Install-Module -Name Microsoft.Data.Sqlite.Tools -Scope AllUsers

第4章: データベース接続の管理

4.1 接続文字列

4.2 データベースへの接続を開く

データベースファイルのパスを指定

SqliteConnectionオブジェクトを作成

接続を開く

4.3 データベース接続を閉じる

データベース操作が完了した後…

または、リソース解放を確実に行うためにDispose()を使用

4.4 usingステートメントに相当するパターン

データベースファイルのパス

第5章: SQLコマンドの実行

5.1 非クエリコマンド (ExecuteNonQuery())

5.2 クエリコマンド (ExecuteReader())

5.3 スカラコマンド (ExecuteScalar())

5.4 データの更新 (UPDATE) および削除 (DELETE)

第6章: パラメータの利用

6.1 パラメータの使用方法

6.2 パラメータを使ったデータの選択 (SELECT)

6.3 様々なデータ型とパラメータ

第7章: トランザクション処理

7.1 トランザクションの使用方法

第8章: エラーハンドリング

8.1 try/catch/finallyブロックの使用

データベースファイルのパス (例: 存在しないパスや読み取り権限がないパスを指定してエラーを発生させる)

$dbPath = “C:\NonExistentFolder\MyDatabase.db”

$connectionString = “Data Source=$dbPath”

または、SQL構文エラーを発生させる

$sqlError = “SELECT FROM Users;” # FROMの後にカラム名がない

第9章: SQLiteデータ型とPowerShell/.NETの型のマッピング

9.1 一般的な型のマッピング

9.2 データリーダーからのデータ取得時の型変換

DataReaderから値を取得

明示的に型キャストする

EmailがNULLの場合もあるため、string? はPowerShellに無いので注意

Nullableな型を扱う場合は、DBNullチェックが必要

または、Null許容型に対応したメソッドを使用 (ADO.NETの機能)

$email = $reader.GetFieldValuestring? # C#/.NETなら可能だが、PowerShellでは少し難しい場合がある

PowerShellではDBNullチェックが最も確実

第10章: 実践的な例

10.1 CSVファイルからのデータインポート

CSVファイルのパス

データベースファイルのパス

10.2 データの取得とPowerShellオブジェクトへの変換

第11章: より高度なトピック

11.1 JOINを使った複数テーブルからのデータ取得

データベース接続とコマンドオブジェクトの準備 (省略)

…

結果の処理 (省略 – 例 10.2 と同様に DataReader から読み込む)

…

11.2 インデックスの利用

データベース接続とコマンドオブジェクトの準備 (省略)

…

11.3 BULK INSERT (大量データ挿入)

第12章: パフォーマンスの考慮事項

第13章: よくある落とし穴とデバッグ

第14章: まとめと次のステップ

コメントする 返信をキャンセル

3.1 `Microsoft.Data.Sqlite` モジュールのインストール

4.4 `using`ステートメントに相当するパターン

5.1 非クエリコマンド (`ExecuteNonQuery()`)

5.2 クエリコマンド (`ExecuteReader()`)

5.3 スカラコマンド (`ExecuteScalar()`)

5.4 データの更新 (`UPDATE`) および削除 (`DELETE`)

6.2 パラメータを使ったデータの選択 (`SELECT`)

8.1 `try/catch/finally`ブロックの使用

コメントする返信をキャンセル