Usar o driver ADO.NET do Spanner

ADO.NET é uma interface genérica para acesso a fontes de dados para .NET. Para usar o ADO.NET com seu aplicativo, use o driver do ADO.NET do Spanner.

O driver do SpannerADO.NET é compatível com bancos de dados do GoogleSQL e do PostgreSQL.

Instalar o driver do ADO.NET do Spanner

Para usar o driver do ADO.NET do Spanner no aplicativo, adicione o pacote a seguir ao seu projeto .NET:

  Google.Cloud.Spanner.DataProvider

Usar o driver do ADO.NET do Spanner

Para criar uma conexão ADO.NET com um banco de dados do Spanner, crie um SpannerConnectionStringBuilder com um nome de banco de dados totalmente qualificado como a string de conexão:

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)}");
    }
}

Para mais informações, consulte o Spanner repositório do GitHub do driver do ADO.NET.

Recursos compatíveis

O diretório de código de exemplos do driver do ADO.NET do Spanner contém exemplos prontos para execução de recursos do Spanner usados com frequência.

Dicas de desempenho

Para ter o melhor desempenho possível ao usar o driver do ADO.NET do Spanner, siga estas práticas recomendadas:

• Parâmetros de consulta: Use parâmetros de consulta em vez de valores inline em instruções SQL. Isso permite que o Spanner armazene em cache e reutilize o plano de execução para instruções SQL usadas com frequência.
• Linguagem de definição de dados (DDL): agrupe várias instruções DDL em um lote em vez de executá-las uma por uma.
• Linguagem de manipulação de dados (DML): agrupe várias instruções DML em um lote em vez de executá-las uma por uma.
• Transações somente leitura: use transações somente leitura para cargas de trabalho que apenas leem dados. As transações somente leitura não fazem bloqueios.
• Tags: Use tags de solicitação e de transação para resolver problemas.

A seguir

• Saiba mais sobre como usar o Spanner com os exemplos de código do driver do ADO.NET .
• Saiba mais sobre ADO.NET.
• Registre um problema no GitHub para relatar uma solicitação de recurso ou bug ou fazer uma pergunta sobre o driver do ADO.NET do Spanner.