使用 Spanner ADO.NET 驅動程式

ADO.NET 是 .NET 的資料來源存取通用介面。如要在應用程式中使用 ADO.NET，請使用 Spanner ADO.NET 驅動程式。

SpannerADO.NET 驅動程式同時支援 GoogleSQL 方言資料庫和 PostgreSQL 方言資料庫。

安裝 Spanner ADO.NET 驅動程式

如要在應用程式中使用 Spanner ADO.NET 驅動程式，請將下列套件新增至 .NET 專案：

  Google.Cloud.Spanner.DataProvider

使用 Spanner ADO.NET 驅動程式

如要建立 ADO.NET 連線至 Spanner 資料庫，請使用完整資料庫名稱做為連線字串，建立 SpannerConnectionStringBuilder：

GoogleSQL

/// <summary>
/// Create an ADO.NET connection to a Spanner database.
/// </summary>
/// <param name="connectionString">
/// A connection string in the format
/// 'Data Source=projects/my-project/instances/my-instance/databases/my-database'.
/// </param>
public static async Task CreateConnection(string connectionString)
{
    // Use a SpannerConnectionStringBuilder to construct a connection string.
    // The SpannerConnectionStringBuilder contains properties for the most
    // used connection string variables.
    var builder = new SpannerConnectionStringBuilder(connectionString)
    {
        // Sets the default isolation level that should be used for all
        // read/write transactions on this connection.
        DefaultIsolationLevel = IsolationLevel.RepeatableRead,

        // The Options property can be used to set any connection property
        // as a key-value pair.
        Options = "statement_cache_size=2000"
    };

    await using var connection = new SpannerConnection(builder.ConnectionString);
    await connection.OpenAsync();

    await using var command = connection.CreateCommand();
    command.CommandText = "SELECT 'Hello World' as Message";
    await using var reader = await command.ExecuteReaderAsync();
    while (await reader.ReadAsync())
    {
        Console.WriteLine($"Greeting from Spanner: {reader.GetString(0)}");
    }
}

PostgreSQL

/// <summary>
/// Create an ADO.NET connection to a Spanner PostgreSQL database.
/// </summary>
/// <param name="connectionString">
/// A connection string in the format
/// 'Data Source=projects/my-project/instances/my-instance/databases/my-database'.
/// </param>
public static async Task CreateConnection(string connectionString)
{
    // Use a SpannerConnectionStringBuilder to construct a connection string.
    // The SpannerConnectionStringBuilder contains properties for the most
    // used connection string variables.
    var builder = new SpannerConnectionStringBuilder(connectionString)
    {
        // Sets the default isolation level that should be used for all
        // read/write transactions on this connection.
        DefaultIsolationLevel = IsolationLevel.RepeatableRead,

        // The Options property can be used to set any connection property
        // as a key-value pair.
        Options = "statement_cache_size=2000"
    };

    await using var connection = new SpannerConnection(builder.ConnectionString);
    await connection.OpenAsync();

    await using var command = connection.CreateCommand();
    command.CommandText = "SELECT 'Hello World' as Message";
    await using var reader = await command.ExecuteReaderAsync();
    while (await reader.ReadAsync())
    {
        Console.WriteLine($"Greeting from Spanner: {reader.GetString(0)}");
    }
}

詳情請參閱 Spanner ADO.NET 驅動程式 GitHub 存放區。

支援功能

Spanner ADO.NET 驅動程式範例程式碼目錄包含常用 Spanner 功能的範例，可直接執行。

效能提示

使用 Spanner ADO.NET 驅動程式時，請遵循下列最佳做法，盡可能提升效能：

• 查詢參數：在 SQL 陳述式中使用查詢參數，而非內嵌值。這樣一來，Spanner 就能快取並重複使用常用 SQL 陳述式的執行計畫。
• 資料庫定義語言 (DDL)：將多個 DDL 陳述式分組為一個批次，而非逐一執行。
• 資料操縱語言 (DML)：將多個 DML 陳述式分組為一個批次，而不是逐一執行。
• 唯讀交易：如要處理只讀取資料的工作負載，請使用唯讀交易。唯讀交易不會採用鎖定。
• 標記：使用要求和交易標記排解問題。

後續步驟

• 進一步瞭解如何搭配使用 Spanner 與 ADO.NET 驅動程式 程式碼範例。
• 進一步瞭解 ADO.NET。
• 提出 GitHub 問題，回報功能要求或錯誤，或詢問 Spanner ADO.NET 驅動程式相關問題。