Parâmetros de Table-Valued (ODBC)

O suporte ODBC para parâmetros com valor de tabela permite que um aplicativo cliente envie dados parametrizados para o servidor com mais eficiência, enviando várias linhas para o servidor com uma chamada.

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

No ODBC, há duas maneiras 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 serão armazenados em matrizes se houver várias linhas no valor da 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 para o valor da tabela podem ser fornecidas em lotes ou uma de cada vez para reduzir os requisitos de memória.

A primeira opção permite que os procedimentos armazenados encapsulam mais lógica de negócios. Por exemplo, um único procedimento armazenado pode encapsular uma transação de entrada de pedido inteira quando os itens de pedido são passados como um parâmetro com valor de tabela. Essa opção é muito eficiente, pois apenas uma única viagem de ida e volta para o servidor é necessária. Como alternativa, você poderia usar procedimentos diferentes para lidar com os itens de cabeçalho de pedido e 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 fazer buffer de todos eles na memória primeiro.

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

Nesta seção

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

Tipo de SQL ODBC para parâmetros de Table-Valued
Descreve o tipo de SQL_SS_TABLE. Esse é um novo tipo ODBC SQL que dá suporte a parâmetros com valor de tabela.

Campos do descritor de parâmetroTable-Valued
Descreve campos de descritor que dão suporte a parâmetros com valor de tabela.

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

Campos de registro de diagnóstico de parâmetroTable-Valued
Descreve dois campos de diagnóstico que foram adicionados aos registros de diagnóstico para dar suporte a parâmetros com valor de tabela.

Atributos de instrução que afetam parâmetros de Table-Valued
Descreve um novo campo de cabeçalho de descritor que permite que colunas de parâmetros com valor de tabela sejam tratadas.

Associação e transferência de dados de parâmetros Table-Valued e valores de coluna
Descreve a associação de parâmetros e como passar um parâmetro com valor de tabela para o servidor.

Metadados de parâmetroTable-Valued para instruções preparadas
Descreve como um aplicativo pode obter metadados para uma chamada de procedimento preparada.

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

Table-Valued conversão de dados de parâmetro e outros erros e avisos
Descreve como processar erros em valores de coluna de parâmetro 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 ao SQL Server 2008.

Resumo da API do parâmetro ODBC Table-Valued
Lista as funções ODBC que dão suporte a parâmetros com valor de tabela.

Exemplos de programação de parâmetro de Table-Valued ODBC
Descreve como executar tarefas comuns.

Consulte Também

SQL Server Native Client (ODBC)
Parâmetros deTable-Valued (SQL Server Native Client)