Creazione di tabelle di SQL Server
Si applica a:
SQL Server Azure SQL DatabaseIstanza gestita di SQL di AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)
OLE DB Driver per SQL Server espone la funzione ITableDefinition::CreateTable che consente ai consumer di creare tabelle di SQL Server. I consumer usano CreateTable per creare tabelle permanenti denominate dal consumer e tabelle permanenti o temporanee con nomi univoci generati dal driver OLE DB per SQL Server.
Quando il consumer chiama ITableDefinition::CreateTable, se il valore della proprietà DBPROP_TBL_TEMPTABLE è VARIANT_TRUE, il driver OLE DB per SQL Server genera un nome di tabella temporanea per il consumer. Il consumer imposta il parametro pTableID del metodo CreateTable su NULL. Le tabelle temporanee con nomi generati dal driver OLE DB per SQL Server non vengono visualizzate nel set di righe TABLES, ma è possibile accedervi tramite l'interfaccia IOpenRowset.
Quando i consumer specificano il nome di tabella nel membro pwszName dell'unione uName nel parametro pTableID, OLE DB Driver per SQL Server crea una tabella di SQL Server con quel nome. Vengono applicati i vincoli di denominazione di tabella di SQL Server e il nome tabella può indicare una tabella permanente o una tabella temporanea locale o globale. Per altre informazioni, vedere CREATE TABLE. Il parametro ppTableID può essere NULL.
OLE DB Driver per SQL Server può generare i nomi di tabelle permanenti o temporanee. Quando il consumer imposta il parametro pTableID su NULL e configura ppTableID perché punti a un DBID* valido, OLE DB Driver per SQL Server restituisce il nome generato della tabella nel membro pwszName dell'unione uName del DBID a cui punta il valore di ppTableID. Per creare una tabella temporanea denominata dal driver OLE DB per SQL Server, il consumer include la proprietà di tabella OLE DB DBPROP_TBL_TEMPTABLE in un set di proprietà di tabella cui viene fatto riferimento nel parametro rgPropertySets. Le tabelle temporanee denominate da OLE DB Driver per SQL Server sono locali.
CreateTable restituisce DB_E_BADTABLEID se il membro eKind del parametro pTableID non indica DBKIND_NAME.
Utilizzo di DBCOLUMNDESC
Il consumer può indicare un tipo di dati della colonna tramite il membro pwszTypeName o il membro wType. Se il consumer specifica il tipo di dati in pwszTypeName, OLE DB Driver per SQL Server ignora il valore di wType.
Se si usa il membro pwszTypeName, il consumer specifica il tipo di dati usando i nomi dei tipi di dati di SQL Server. I nomi dei tipi di dati validi sono quelli restituiti nella colonna TYPE_NAME del set di righe dello schema PROVIDER_TYPES.
OLE DB Driver per SQL Server riconosce un subset di valori DBTYPE enumerati da OLE DB nel membro wType. Per altre informazioni, vedere Mapping dei tipi di dati in ITableDefinition.
Nota
CreateTable restituisce DB_E_BADTYPE se il consumer imposta il membro pTypeInfo o pclsid per specificare il tipo di dati della colonna.
Il consumer specifica il nome di colonna nel membro pwszName dell'unione uName del membro dbcid di DBCOLUMNDESC. Il nome di colonna viene specificato come stringa di caratteri Unicode. Il membro eKind di dbcid deve essere DBKIND_NAME. CreateTable restituisce DB_E_BADCOLUMNID se eKind non è valido, se pwszName è NULL o se il valore di pwszName non è un identificatore di SQL Server valido.
Tutte le proprietà delle colonne sono disponibili in tutte le colonne definite per la tabella. CreateTable può restituire DB_S_ERRORSOCCURRED o DB_E_ERRORSOCCURRED in caso di conflitto tra i valori di proprietà impostati. CreateTable restituisce un errore quando impostazioni delle proprietà delle colonne non valide determinano un errore di creazione tabelle di SQL Server.
Le proprietà delle colonne in un parametro DBCOLUMNDESC vengono interpretate nel modo seguente.
| ID proprietà | Descrizione |
|---|---|
| DBPROP_COL_AUTOINCREMENT | R/W (L/S): Lettura/Scrittura Predefinito: VARIANT_FALSE Descrizione: imposta la proprietà Identity nella colonna creata. Per SQL Server, la proprietà Identity è valida per una singola colonna all'interno di una tabella. L'impostazione della proprietà su VARIANT_TRUE per più di una colonna genera un errore quando il driver OLE DB per SQL Server tenta di creare la tabella nel server. La proprietà Identity di SQL Server è valida solo per i tipi integer, numeric e decimal quando la scala è 0. L'impostazione della proprietà su VARIANT_TRUE in una colonna di qualsiasi altro tipo di dati genera un errore quando il driver OLE DB per SQL Server tenta di creare la tabella nel server. Il driver OLE DB per SQL Server restituisce DB_S_ERRORSOCCURRED quando le proprietà DBPROP_COL_AUTOINCREMENT e DBPROP_COL_NULLABLE sono entrambe VARIANT_TRUE e il membro dwOption di DBPROP_COL_NULLABLE non è DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED viene restituito quando DBPROP_COL_AUTOINCREMENT e DBPROP_COL_NULLABLE sono entrambe VARIANT_TRUE e il membro dwOption di DBPROP_COL_NULLABLE è uguale a DBPROPOPTIONS_REQUIRED. La colonna viene definita con la proprietà Identity di SQL Server e il membro dwStatus di DBPROP_COL_NULLABLE viene impostato su DBPROPSTATUS_CONFLICTING. |
| DBPROP_COL_DEFAULT | R/W (L/S): Lettura/Scrittura Predefinito: nessuno Descrizione: crea un vincolo DEFAULT di SQL Server per la colonna. Il membro vValue di DBPROP può essere uno qualsiasi di diversi tipi. Il membro vValue.vt deve specificare un tipo compatibile con il tipo di dati della colonna. La definizione di BSTR N/A come valore predefinito per una colonna definita come DBTYPE_WSTR rappresenta una corrispondenza compatibile. La definizione dello stesso valore predefinito in una colonna definita come DBTYPE_R8 genera un errore quando il driver OLE DB per SQL Server tenta di creare la tabella nel server. |
| DBPROP_COL_DESCRIPTION | R/W (L/S): Lettura/Scrittura Predefinito: nessuno Descrizione: la proprietà della colonna DBPROP_COL_DESCRIPTION non viene implementata da OLE DB Driver per SQL Server. Il membro dwStatus della struttura DBPROP restituisce DBPROPSTATUS_NOTSUPPORTED quando il consumer tenta di scrivere il valore della proprietà. L'impostazione della proprietà non costituisce un errore irreversibile per OLE DB Driver per SQL Server. Se tutti gli altri valori di parametro sono validi, viene creata la tabella di SQL Server. |
| DBPROP_COL_FIXEDLENGTH | R/W (L/S): Lettura/Scrittura Predefinito: VARIANT_FALSE Descrizione: OLE DB Driver per SQL Server usa DBPROP_COL_FIXEDLENGTH per determinare il mapping del tipo di dati quando il consumer definisce il tipo di dati di una colonna usando il membro wType di DBCOLUMNDESC. Per altre informazioni, vedere Mapping dei tipi di dati in ITableDefinition. |
| DBPROP_COL_NULLABLE | R/W (L/S): Lettura/Scrittura Predefinito: nessuno Descrizione: durante la creazione della tabella, OLE DB Driver per SQL Server indica se la colonna deve accettare valori Null se la proprietà è impostata. Quando la proprietà non è impostata, la possibilità di accettare valori NULL per la colonna è determinata dall'opzione di database predefinita ANSI_NULLS di SQL Server. OLE DB Driver per SQL Server è un provider compatibile con ISO. Le sessioni connesse adottano comportamenti ISO. Se il consumer non imposta DBPROP_COL_NULLABLE, le colonne accettano valori Null. |
| DBPROP_COL_PRIMARYKEY | R/W (L/S): Lettura/Scrittura Predefinito: VARIANT_FALSE Descrizione: se il valore è VARIANT_TRUE, OLE DB Driver per SQL Server crea la colonna con un vincolo PRIMARY KEY. Se definita come proprietà della colonna, solo una singola colonna può determinare il vincolo. L'impostazione della proprietà su VARIANT_TRUE per più di una colonna restituisce un errore quando OLE DB Driver per SQL Server tenta di creare la tabella di SQL Server. Nota: il consumer può usare IIndexDefinition::CreateIndex per creare un vincolo PRIMARY KEY in due o più colonne. Il driver OLE DB per SQL Server restituisce DB_S_ERRORSOCCURRED quando le proprietà DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e il membro dwOption di DBPROP_COL_UNIQUE non è DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED viene restituito quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e il membro dwOption di DBPROP_COL_UNIQUE è uguale a DBPROPOPTIONS_REQUIRED. La colonna viene definita con la proprietà Identity di SQL Server e il membro dwStatus di DBPROP_COL_PRIMARYKEY viene impostato su DBPROPSTATUS_CONFLICTING. Il driver OLE DB per SQL Server restituisce un errore quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_NULLABLE sono entrambe VARIANT_TRUE. OLE DB Driver per SQL Server restituisce un errore da SQL Server quando il consumer tenta di creare un vincolo PRIMARY KEY in una colonna con tipo di dati di SQL Server non valido. Non è possibile definire vincoli PRIMARY KEY in colonne create con i tipi di dati di SQL Server bit, text, ntext e image. |
| DBPROP_COL_UNIQUE | R/W (L/S): Lettura/Scrittura Impostazione predefinita: VARIANT_FALSE Descrizione: applica un vincolo UNIQUE di SQL Server alla colonna. Se è definita come proprietà della colonna, il vincolo viene applicato solo a una singola colonna. Il consumer può usare IIndexDefinition::CreateIndex per applicare un vincolo UNIQUE nei valori combinati di due o più colonne. Il driver OLE DB per SQL Server restituisce DB_S_ERRORSOCCURRED quando le proprietà DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e dwOption non è DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED viene restituito quando DBPROP_COL_PRIMARYKEY e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e dwOption è uguale a DBPROPOPTIONS_REQUIRED. La colonna viene definita con la proprietà Identity di SQL Server e il membro dwStatus di DBPROP_COL_PRIMARYKEY viene impostato su DBPROPSTATUS_CONFLICTING. Il driver OLE DB per SQL Server restituisce DB_S_ERRORSOCCURRED quando le proprietà DBPROP_COL_NULLABLE e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e dwOption non è DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED viene restituito quando DBPROP_COL_NULLABLE e DBPROP_COL_UNIQUE sono entrambe VARIANT_TRUE e dwOption è uguale a DBPROPOPTIONS_REQUIRED. La colonna viene definita con la proprietà Identity di SQL Server e il membro dwStatus di DBPROP_COL_NULLABLE viene impostato su DBPROPSTATUS_CONFLICTING. OLE DB Driver per SQL Server restituisce un errore da SQL Server quando il consumer tenta di creare un vincolo UNIQUE in una colonna con tipo di dati di SQL Server non valido. Non è possibile definire vincoli UNIQUE in colonne create con il tipo di dati bit di SQL Server. |
Quando il consumer chiama ITableDefinition::CreateTable, il driver OLE DB per SQL Server interpreta le proprietà della tabella come riportato di seguito.
| ID proprietà | Descrizione |
|---|---|
| DBPROP_TBL_TEMPTABLE | R/W (L/S): Lettura/Scrittura Predefinito: VARIANT_FALSE Descrizione: per impostazione predefinita, OLE DB Driver per SQL Server crea tabelle denominate dal consumer. se il valore è VARIANT_TRUE, OLE DB Driver per SQL Server genera un nome di tabella temporanea per il consumer. Il consumer imposta il parametro pTableID di CreateTable su NULL. Il parametro ppTableID deve contenere un puntatore valido. |
Se il consumer richiede l'apertura di un set di righe in una tabella creata correttamente, il driver OLE DB per SQL Server apre un set di righe supportato dal cursore. Qualsiasi proprietà del set di righe può essere indicata nei set di proprietà passati.
In questo esempio viene creata una tabella di 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);
}
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per