Parâmetros com valor de tabela (ODBC)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

O suporte de ODBC para parâmetros com valor de tabela permite que o aplicativo cliente envie dados com parâmetros para o servidor de forma mais eficiente, enviando várias linhas ao servidor com uma chamada.

Para obter informações sobre parâmetros com valor de tabela no servidor, consulte Usar parâmetros Table-Valued (Mecanismo de Banco de Dados).

No ODBC, há duas formas de enviar parâmetros com valor de tabela para o servidor:

  • Todos os dados de parâmetro com valor de tabela podem estar na memória no momento em que SQLExecDirect ou SQLExecute é chamado. Esses dados são armazenados em matrizes, se houver várias linhas com valor de tabela.

  • Um aplicativo pode especificar dados em execução para um parâmetro com valor de tabela quando SQLExecDirect ou SQLExecute é chamado. Nesse caso, linhas de dados com valor de tabela podem ser fornecidas em lotes ou a qualquer momento, a fim de reduzir os requisitos de memória.

A primeira opção permite que os procedimentos armazenados encapsulem mais lógica corporativa. Por exemplo, um único procedimento armazenado pode encapsular toda uma transação de entrada de pedido quando o item solicitado for transmitido como um parâmetro com valor de tabela. Essa opção é muito eficiente, porque é necessária apenas uma viagem de ida e volta ao servidor. Como alternativa, você pode usar procedimentos diferentes para lidar com o cabeçalho do pedido e itens do pedido separadamente, o que exigiria mais código e um contrato mais complexo entre o cliente e o servidor.

O segundo método fornece um mecanismo eficiente para operações em massa com grandes quantidades de dados. Isso permite que um aplicativo transmita linhas de dados para o servidor sem precisar armazenar todas elas em buffer na memória antes.

Você pode criar restrições e chaves primárias quando criar a variável da tabela. Restrições são uma boa forma de assegurar que os dados de uma tabela atendam a requisitos específicos.

Nesta seção

Usos de parâmetros ODBC com valor de tabela
Descreve os cenários principais de usuário para parâmetros com valor de tabela e ODBC.

Tipo ODBC SQL para parâmetros com valor de tabela
Descreve o tipo SQL_SS_TABLE. Esse é um novo tipo ODBC SQL que oferece suporte a parâmetros com valor de tabela.

Campos do descritor de parâmetro com valor de tabela
Descreve campos do descritor que oferece suporte a parâmetros com valor de tabela.

Campos descritores para colunas constituintes do parâmetro com valor de tabela
Descreve campos de descritor que têm significado para parâmetros com valor de tabela.

Campos de registro de diagnóstico de parâmetro com valor de tabela
Descreve dois campos de diagnóstico que foram acrescentados a registros de diagnóstico para oferecer suporte a parâmetros com valor de tabela.

Atributos de instruções que afetam parâmetros com valor de tabela
Descreve um novo campo de cabeçalho do descritor que permite tratar as colunas de parâmetros com valor de tabela.

Associação e transferência de dados de parâmetros com valor de tabela e valores de coluna
Descreve a associação de parâmetro e como transmitir um parâmetro com valor de tabela ao servidor.

Metadados do parâmetro com valor de tabela para instruções preparadas
Descreve como um aplicativo pode obter metadados para uma chamada de procedimento preparada.

Metadados adicionais de parâmetros com valor de tabela
Descreve como usar SQLProcedureColumns, SQLTables e SQLColumns para recuperar metadados para um parâmetro com valor de tabela.

Conversão de dados de parâmetros com valor de tabela e outros erros e avisos
Descreve como processar erros em valores de colunas de parâmetros com valor de tabela.

Compatibilidade entre versões
Descreve conflitos que podem ocorrer quando parâmetros com valor de tabela são usados por um cliente ou servidor de uma versão anterior a SQL Server 2008 (10.0.x).

Resumo de APIs de parâmetros com valor de tabela ODBC
Lista as funções do ODBC com suporte a parâmetros com valor de tabela.

Consulte Também

SQL Server Native Client (ODBC)
Parâmetros com valor de tabela (SQL Server Native Client)