Criando tabelas do SQL Server
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
O OLE DB Driver for SQL Server expõe a função ITableDefinition::CreateTable, permitindo que os consumidores criem tabelas do SQL Server. Os consumidores usam CreateTable para criar tabelas permanentes nomeadas pelo consumidor, além de tabelas permanentes ou temporárias com nomes exclusivos gerados pelo OLE DB Driver for SQL Server.
Quando o consumidor chama ITableDefinition::CreateTable, se o valor da propriedade DBPROP_TBL_TEMPTABLE é VARIANT_TRUE, o OLE DB Driver for SQL Server gera um nome de tabela temporária para o consumidor. O consumidor define o parâmetro pTableID do método CreateTable como NULL. As tabelas temporárias com nomes gerados pelo OLE DB Driver for SQL Server não são exibidas no conjunto de linhas TABLES, mas são acessíveis pela interface IOpenRowset.
Quando os consumidores especificam o nome da tabela no membro pwszName da união uName no parâmetro pTableID, o OLE DB Driver for SQL Server cria uma tabela SQL Server com esse nome. As restrições de nomeação de tabela SQL Server se aplicam, e o nome da tabela pode indicar uma tabela permanente, ou uma tabela temporária local ou global. Para obter mais informações, confira CREATE TABLE. O parâmetro ppTableID pode ser NULL.
O Driver do OLE DB para SQL Server pode gerar os nomes de tabelas permanentes ou temporárias. Quando o consumidor define o parâmetro pTableID como NULL e define ppTableID para que ele aponte para um DBID válido, o Driver do OLE DB para SQL Server retorna o nome gerado da tabela no membro pwszName da união uName do DBID apontado no valor de ppTableID. Para criar uma tabela temporária nomeada pelo OLE DB Driver for SQL Server, o consumidor inclui a propriedade de tabela DBPROP_TBL_TEMPTABLE do OLE DB em um conjunto de propriedades de tabela referenciado no parâmetro rgPropertySets. As tabelas temporárias nomeadas pelo Driver do OLE DB para SQL Server são locais.
CreateTable retornará DB_E_BADTABLEID se o membro eKind do parâmetro pTableID não indicar DBKIND_NAME.
Uso de DBCOLUMNDESC
O consumidor pode indicar um tipo de dados de coluna usando o membro pwszTypeName ou o membro wType. Se o consumidor especificar o tipo de dados em pwszTypeName, o Driver do OLE DB para SQL Server ignorará o valor de wType.
Se estiver usando o membro pwszTypeName, o consumidor especificará o tipo de dados usando nomes de tipo de dados do SQL Server. Os nomes de tipo de dados válidos são aqueles retornados na coluna de TYPE_NAME do conjunto de linhas de esquema de PROVIDER_TYPES.
O Driver do OLE DB para SQL Server reconhece um subconjunto de valores DBTYPE enumerados por OLE DB no membro wType. Para obter mais informações, confira Mapeamento de tipo de dados em ITableDefinition.
Observação
CreateTable retornará DB_E_BADTYPE se o consumidor definir o membro pTypeInfo ou pclsid para especificar o tipo de dados de coluna.
O consumidor especifica o nome da coluna no membro pwszName da união uName do membro dbcid de DBCOLUMNDESC. O nome da coluna é especificado como uma cadeia de caracteres Unicode. O membro eKind de dbcid precisa ser DBKIND_NAME. CreateTable retornará DB_E_BADCOLUMNID se eKind for inválido, se pwszName for NULL ou se o valor de pwszName não for um identificador válido do SQL Server.
Todas as propriedades de coluna estão disponíveis em todas as colunas definidas para a tabela. CreateTable poderá retornar DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED se os valores de propriedade forem definidos em conflito. CreateTable retornará um erro quando as configurações de propriedade de coluna inválidas causarem uma falha na criação de tabelas do SQL Server.
As propriedades de coluna em um DBCOLUMNDESC são interpretadas da seguinte maneira.
| ID da propriedade | Descrição |
|---|---|
| DBPROP_COL_AUTOINCREMENT | L/G: Leitura/gravação Padrão: Descrição de VARIANT_FALSE: define a propriedade IDENTITY na coluna criada. Para SQL Server, a propriedade de identidade é válida para uma única coluna de uma tabela. A definição da propriedade como VARIANT_TRUE para mais de uma única coluna gera um erro quando o OLE DB Driver for SQL Server tenta criar a tabela no servidor. A propriedade de identidade do SQL Server só é válida para os tipos integer, numeric e decimal quando a escala é 0. A definição da propriedade como VARIANT_TRUE em uma coluna de qualquer tipo de dados gera um erro quando o OLE DB Driver for SQL Server tenta criar a tabela no servidor. O OLE DB Driver for SQL Server retorna DB_S_ERRORSOCCURRED quando DBPROP_COL_AUTOINCREMENT e DBPROP_COL_NULLABLE são VARIANT_TRUE e a dwOption de DBPROP_COL_NULLABLE não é DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED é retornado quando DBPROP_COL_AUTOINCREMENT e DBPROP_COL_NULLABLE são VARIANT_TRUE e dwOption de DBPROP_COL_NULLABLE é igual a DBPROPOPTIONS_REQUIRED. A coluna é definida com a propriedade de identidade SQL Server e o membro dwStatus de DBPROP_COL_NULLABLE é definido como DBPROPSTATUS_CONFLICTING. |
| DBPROP_COL_DEFAULT | L/G: Leitura/gravação Padrão: Nenhum Descrição: cria uma restrição SQL Server DEFAULT para a coluna. O membro vValue de DBPROP pode ser qualquer um dentre inúmeros tipos. O membro vValue.vt deve especificar um tipo compatível com o tipo de dados da coluna. Por exemplo, a definição de BSTR N/A como o valor padrão para uma coluna definida como DBTYPE_WSTR é uma correspondência compatível. A definição do mesmo padrão em uma coluna definida como DBTYPE_R8 gera um erro quando o OLE DB Driver for SQL Server tenta criar a tabela no servidor. |
| DBPROP_COL_DESCRIPTION | L/G: Leitura/gravação Padrão: Nenhum Descrição: a propriedade de coluna DBPROP_COL_DESCRIPTION não é implementada pelo Driver do OLE DB para SQL Server. O membro dwStatus da estrutura DBPROP retorna DBPROPSTATUS_NOTSUPPORTED quando o consumidor tenta gravar o valor da propriedade. A configuração da propriedade não constitui um erro fatal para o Driver do OLE DB para SQL Server. Se todos os outros valores de parâmetro forem válidos, será criada a tabela do SQL Server. |
| DBPROP_COL_FIXEDLENGTH | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server usa DBPROP_COL_FIXEDLENGTH para determinar o mapeamento de tipos de dados quando o consumidor define um tipo de dados de coluna usando o membro wType de DBCOLUMNDESC. Para obter mais informações, confira Mapeamento de tipo de dados em ITableDefinition. |
| DBPROP_COL_NULLABLE | L/G: Leitura/gravação Padrão: Nenhum Descrição: ao criar a tabela, o Driver do OLE DB para SQL Server indica se a coluna deve aceitar valores nulos se a propriedade é definida. Quando a propriedade não é definida, a capacidade da coluna de aceitar NULL como valor é determinado pela opção de banco de dados padrão ANSI_NULLS do SQL Server. O Driver do OLE DB para SQL Server é um provedor em conformidade com o padrão ISO. Sessões conectadas exibem comportamentos de ISO. Se o consumidor não definir DBPROP_COL_NULLABLE, as colunas aceitarão valores nulos. |
| DBPROP_COL_PRIMARYKEY | L/G: Leitura/gravação Padrão: Descrição de VARIANT_FALSE: quando é VARIANT_TRUE, o Driver do OLE DB para SQL Server cria a coluna com uma restrição de PRIMARY KEY. Quando definido como uma propriedade de coluna, só uma única coluna pode determinar a restrição. A definição da propriedade como VARIANT_TRUE para mais de uma única coluna gera um erro quando o OLE DB Driver for SQL Server tenta criar a tabela do SQL Server. Observação: o consumidor pode usar IIndexDefinition::CreateIndex para criar uma restrição de PRIMARY KEY em duas ou mais colunas. O OLE DB Driver for SQL Server retorna DB_S_ERRORSOCCURRED quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption de DBPROP_COL_UNIQUE não é DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED é retornado quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption de DBPROP_COL_UNIQUE é igual a DBPROPOPTIONS_REQUIRED. A coluna é definida com a propriedade de identidade do SQL Server e o membro dwStatus de DBPROP_COL_PRIMARYKEY é definido como DBPROPSTATUS_CONFLICTING. O OLE DB Driver for SQL Server retorna um erro quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_NULLABLE são VARIANT_TRUE. O OLE DB Driver for SQL Server retorna um erro do SQL Server quando o consumidor tenta criar a restrição de PRIMARY KEY em uma coluna de um tipo de dados inválido do SQL Server. Não podem ser definidas restrições de PRIMARY KEY em colunas criadas com os tipos de dados bit, text, ntext e image do SQL Server. |
| DBPROP_COL_UNIQUE | L/G: Leitura/gravação Padrão: Descrição de VARIANT_FALSE: Aplica uma restrição UNIQUE do SQL Server à coluna. Quando definido como uma propriedade de coluna, a restrição só é aplicada em uma única coluna. O consumidor pode usar IIndexDefinition::CreateIndex para aplicar uma restrição de UNIQUE nos valores combinados de duas ou mais colunas. O OLE DB Driver for SQL Server retorna DB_S_ERRORSOCCURRED quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption não é DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED é retornado quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption é igual a DBPROPOPTIONS_REQUIRED. A coluna é definida com a propriedade de identidade do SQL Server e o membro dwStatus de DBPROP_COL_PRIMARYKEY é definido como DBPROPSTATUS_CONFLICTING. O OLE DB Driver for SQL Server retorna DB_S_ERRORSOCCURRED quando DBPROP_COL_NULLABLE e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption não é DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED é retornado quando DBPROP_COL_NULLABLE e DBPROP_COL_UNIQUE são VARIANT_TRUE e dwOption é igual a DBPROPOPTIONS_REQUIRED. A coluna é definida com a propriedade de identidade SQL Server e o membro dwStatus de DBPROP_COL_NULLABLE é definido como DBPROPSTATUS_CONFLICTING. O OLE DB Driver for SQL Server retorna um erro do SQL Server quando o consumidor tenta criar a restrição de UNIQUE em uma coluna de um tipo de dados inválido do SQL Server. Não é possível definir restrições de UNIQUE em colunas criadas com o tipo de dados bit do SQL Server. |
Quando o consumidor chama ITableDefinition::CreateTable, o OLE DB Driver for SQL Server interpreta as propriedades de tabela conforme mostrado a seguir.
| ID da propriedade | Descrição |
|---|---|
| DBPROP_TBL_TEMPTABLE | L/G: Leitura/gravação Padrão: Descrição de VARIANT_FALSE: Por padrão, o Driver do OLE DB para SQL Server cria tabelas nomeadas pelo consumidor. Quando VARIANT_TRUE, o Driver do OLE DB para SQL Server gera um nome de tabela temporária para o consumidor. O consumidor define o parâmetro pTableID de CreateTable como NULL. O parâmetro ppTableID precisa conter um ponteiro válido. |
Se o consumidor solicitar que um conjunto de linhas seja aberto em uma tabela criada com êxito, o OLE DB Driver for SQL Server abrirá um conjunto de linhas com suporte de cursor. Qualquer propriedade de conjunto de linhas pode ser indicada nos conjuntos de propriedade passados.
O exemplo a seguir cria uma tabela do SQL Server.
// This CREATE TABLE statement shows the details of the table created by
// the following example code.
//
// CREATE TABLE OrderDetails
// (
// OrderID int NOT NULL
// ProductID int NOT NULL
// CONSTRAINT PK_OrderDetails
// PRIMARY KEY CLUSTERED (OrderID, ProductID),
// UnitPrice money NOT NULL,
// Quantity int NOT NULL,
// Discount decimal(2,2) NOT NULL
// DEFAULT 0
// )
//
// The PRIMARY KEY constraint is created in an additional example.
HRESULT CreateTable
(
ITableDefinition* pITableDefinition
)
{
DBID dbidTable;
const ULONG nCols = 5;
ULONG nCol;
ULONG nProp;
DBCOLUMNDESC dbcoldesc[nCols];
HRESULT hr;
// Set up column descriptions. First, set default property values for
// the columns.
for (nCol = 0; nCol < nCols; nCol++)
{
dbcoldesc[nCol].pwszTypeName = NULL;
dbcoldesc[nCol].pTypeInfo = NULL;
dbcoldesc[nCol].rgPropertySets = new DBPROPSET;
dbcoldesc[nCol].pclsid = NULL;
dbcoldesc[nCol].cPropertySets = 1;
dbcoldesc[nCol].ulColumnSize = 0;
dbcoldesc[nCol].dbcid.eKind = DBKIND_NAME;
dbcoldesc[nCol].wType = DBTYPE_I4;
dbcoldesc[nCol].bPrecision = 0;
dbcoldesc[nCol].bScale = 0;
dbcoldesc[nCol].rgPropertySets[0].rgProperties =
new DBPROP[NCOLPROPS_MAX];
dbcoldesc[nCol].rgPropertySets[0].cProperties = NCOLPROPS_MAX;
dbcoldesc[nCol].rgPropertySets[0].guidPropertySet =
DBPROPSET_COLUMN;
for (nProp = 0; nProp < NCOLPROPS_MAX; nProp++)
{
dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
dwOptions = DBPROPOPTIONS_REQUIRED;
dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].colid
= DB_NULLID;
VariantInit(
&(dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
vValue));
dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
vValue.vt = VT_BOOL;
}
}
// Set the column-specific information.
dbcoldesc[0].dbcid.uName.pwszName = L"OrderID";
dbcoldesc[0].rgPropertySets[0].rgProperties[0].dwPropertyID =
DBPROP_COL_NULLABLE;
dbcoldesc[0].rgPropertySets[0].rgProperties[0].vValue.boolVal =
VARIANT_FALSE;
dbcoldesc[0].rgPropertySets[0].cProperties = 1;
dbcoldesc[1].dbcid.uName.pwszName = L"ProductID";
dbcoldesc[1].rgPropertySets[0].rgProperties[0].dwPropertyID =
DBPROP_COL_NULLABLE;
dbcoldesc[1].rgPropertySets[0].rgProperties[0].vValue.boolVal =
VARIANT_FALSE;
dbcoldesc[1].rgPropertySets[0].cProperties = 1;
dbcoldesc[2].dbcid.uName.pwszName = L"UnitPrice";
dbcoldesc[2].wType = DBTYPE_CY;
dbcoldesc[2].rgPropertySets[0].rgProperties[0].dwPropertyID =
DBPROP_COL_NULLABLE;
dbcoldesc[2].rgPropertySets[0].rgProperties[0].vValue.boolVal =
VARIANT_FALSE;
dbcoldesc[2].rgPropertySets[0].cProperties = 1;
dbcoldesc[3].dbcid.uName.pwszName = L"Quantity";
dbcoldesc[3].rgPropertySets[0].rgProperties[0].dwPropertyID =
DBPROP_COL_NULLABLE;
dbcoldesc[3].rgPropertySets[0].rgProperties[0].vValue.boolVal =
VARIANT_FALSE;
dbcoldesc[3].rgPropertySets[0].cProperties = 1;
dbcoldesc[4].dbcid.uName.pwszName = L"Discount";
dbcoldesc[4].wType = DBTYPE_NUMERIC;
dbcoldesc[4].bPrecision = 2;
dbcoldesc[4].bScale = 2;
dbcoldesc[4].rgPropertySets[0].rgProperties[0].dwPropertyID =
DBPROP_COL_NULLABLE;
dbcoldesc[4].rgPropertySets[0].rgProperties[0].vValue.boolVal =
VARIANT_FALSE;
dbcoldesc[4].rgPropertySets[0].rgProperties[1].dwPropertyID =
DBPROP_COL_DEFAULT;
dbcoldesc[4].rgPropertySets[0].rgProperties[1].vValue.vt = VT_BSTR;
dbcoldesc[4].rgPropertySets[0].rgProperties[1].vValue.bstrVal =
SysAllocString(L"0");
dbcoldesc[4].rgPropertySets[0].cProperties = 2;
// Set up the dbid for OrderDetails.
dbidTable.eKind = DBKIND_NAME;
dbidTable.uName.pwszName = L"OrderDetails";
if (FAILED(hr = pITableDefinition->CreateTable(NULL, &dbidTable,
nCols, dbcoldesc, NULL, 0, NULL, NULL, NULL)))
{
DumpError(pITableDefinition, IID_ITableDefinition);
goto SAFE_EXIT;
}
SAFE_EXIT:
// Clean up dynamic allocation in the property sets.
for (nCol = 0; nCol < nCols; nCol++)
{
for (nProp = 0; nProp < NCOLPROPS_MAX; nProp++)
{
if (dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
vValue.vt == VT_BSTR)
{
SysFreeString(dbcoldesc[nCol].rgPropertySets[0].
rgProperties[nProp].vValue.bstrVal);
}
}
delete [] dbcoldesc[nCol].rgPropertySets[0].rgProperties;
delete [] dbcoldesc[nCol].rgPropertySets;
}
return (hr);
}