Création de tables SQL Server
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Le pilote OLE DB pour SQL Server expose la fonction ITableDefinition::CreateTable avec laquelle les consommateurs peuvent créer des tables SQL Server. Les consommateurs font appel à la fonction CreateTable pour créer des tables permanentes nommées par les consommateurs, et des tables permanentes ou temporaires dotées de noms uniques générés par le pilote OLE DB pour SQL Server.
Lorsque le consommateur appelle ITableDefinition::CreateTable, si la valeur de la propriété DBPROP_TBL_TEMPTABLE est VARIANT_TRUE, le pilote OLE DB pour SQL Server génère un nom de table temporaire pour le consommateur. Le consommateur attribue la valeur NULL au paramètre pTableID de la méthode CreateTable. Les tables temporaires munies de noms générés par le pilote OLE DB pour SQL Server n’apparaissent pas dans l’ensemble de lignes TABLES, mais sont accessibles par le biais de l’interface IOpenRowset.
Lorsque les consommateurs spécifient le nom de la table dans le membre pwszName de l’union uName au sein du paramètre pTableID, le pilote OLE DB pour SQL Server crée une table SQL Server avec ce nom. Des contraintes en matière d'affectation de noms aux tables SQL Server s'appliquent et le nom de la table peut indiquer une table permanente ou une table temporaire locale ou globale. Pour plus d’informations, consultez CREATE TABLE. Le paramètre ppTableID peut avoir la valeur NULL.
OLE DB Driver pour SQL Server peut générer les noms des tables permanentes ou temporaires. Quand le consommateur définit le paramètre pTableID sur NULL et ppTableID pour qu’il pointe sur un DBID* valide, OLE DB Driver pour SQL Server retourne le nom généré de la table dans le membre pwszName de l’union uName du DBID vers lequel pointe la valeur de ppTableID. Pour créer une table temporaire nommée par le pilote OLE DB pour SQL Server, le consommateur inclut la propriété de table OLE DB DBPROP_TBL_TEMPTABLE dans un jeu de propriétés de table référencé dans le paramètre rgPropertySets. Les tables temporaires nommées OLE DB Driver pour SQL Server sont locales.
CreateTable retourne DB_E_BADTABLEID si le membre eKind du paramètre pTableID n’indique pas DBKIND_NAME.
Utilisation de la structure DBCOLUMNDESC
Le consommateur peut indiquer un type de données de colonne en utilisant soit le membre pwszTypeName, soit le membre wType. Si le consommateur spécifie le type de données dans pwszTypeName, le fournisseur OLE DB Driver pour SQL Server ignore la valeur de wType.
S’il utilise le membre pwszTypeName, le consommateur spécifie le type de données à l’aide de noms du type de données SQL Server. Les noms de type de données valides sont les noms retournés dans la colonne TYPE_NAME de l'ensemble de lignes de schéma PROVIDER_TYPES.
Le fournisseur OLE DB Driver pour SQL Server reconnaît un sous-ensemble de valeurs DBTYPE énumérées dans le membre wType. Pour plus d'informations, voir Mappage de types de données dans ITableDefinition.
Notes
CreateTable retourne DB_E_BADTYPE si le consommateur choisit le membre pTypeInfo ou pclsid pour spécifier le type de données de colonne.
Le consommateur spécifie le nom de colonne dans le membre pwszName de l’union uName du membre dbcid DBCOLUMNDESC. Le nom de colonne est spécifié en tant que chaîne de caractères Unicode. Le membre eKind de dbcid doit être DBKIND_NAME. CreateTable retourne DB_E_BADCOLUMNID si le membre eKind n’est pas valide, si pwszName possède la valeur NULL ou si la valeur de pwszName n’est pas un identificateur SQL Server valide.
Toutes les propriétés de colonne sont disponibles dans toutes les colonnes définies pour la table. CreateTable peut retourner DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED si les valeurs des propriétés sont en conflit. CreateTable retourne une erreur lorsque les paramètres des propriétés de colonne non valides entraîne un échec lors de la création de tables SQL Server.
Les propriétés des colonnes dans une structure DBCOLUMNDESC se définissent de la manière suivante.
| ID de propriété | Description |
|---|---|
| DBPROP_COL_AUTOINCREMENT | R/W : Lecture/écriture Valeur par défaut : Description de VARIANT_FALSE : Définit la propriété d’identité sur la colonne créée. Pour SQL Server, la propriété d'identité est valide pour une colonne unique au sein d'une table. La définition de la propriété sur VARIANT_TRUE pour plusieurs colonnes uniques génère une erreur quand le pilote OLE DB pour SQL Server tente de créer la table sur le serveur. La propriété d’identité SQL Server est uniquement valide pour les types integer, numeric et decimal lorsque l’échelle est définie sur 0. Toute définition de la propriété sur VARIANT_TRUE dans une colonne de n’importe quel autre type de données génère une erreur lors de la tentative de création de la table sur le serveur par le pilote OLE DB pour SQL Server. Le pilote OLE DB pour SQL Server retourne DB_S_ERRORSOCCURRED lorsque DBPROP_COL_AUTOINCREMENT et DBPROP_COL_NULLABLE sont tous les deux définis sur VARIANT_TRUE et que la valeur dwOption de DBPROP_COL_NULLABLE n’est pas DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED est retourné lorsque DBPROP_COL_AUTOINCREMENT et DBPROP_COL_NULLABLE sont tous les deux définis sur VARIANT_TRUE et quand la valeur dwOption de DBPROP_COL_NULLABLE est égale à DBPROPOPTIONS_REQUIRED. La colonne est définie avec la propriété d’identité SQL Server et le membre dwStatus DBPROP_COL_NULLABLE est défini sur DBPROPSTATUS_CONFLICTING. |
| DBPROP_COL_DEFAULT | R/W : Lecture/écriture Valeur par défaut : None Description : Crée une contrainte DEFAULT SQL Server pour la colonne. Le membre vValue DBPROP peut appartenir aux types suivants. Le membre vValue.vt doit spécifier un type compatible avec le type de données de la colonne. Par exemple, le choix de BSTR N/A comme valeur par défaut d'une colonne définie en tant que DBTYPE_WSTR offre une valeur de correspondance compatible. Si vous définissez cette même valeur par défaut dans une colonne en tant que DBTYPE_R8, une erreur se produit au moment où le pilote OLE DB pour SQL Server tente de créer la table sur le serveur. |
| DBPROP_COL_DESCRIPTION | R/W : Lecture/écriture Valeur par défaut : None Description : La propriété de colonne DBPROP_COL_DESCRIPTION n’est pas implémentée par le pilote OLE DB pour SQL Server. Le membre dwStatus de la structure DBPROP retourne DBPROPSTATUS_NOTSUPPORTED lorsque le consommateur tente d’écrire la valeur de propriété. La définition de la propriété ne constitue pas une erreur irrécupérable pour le fournisseur OLE DB Driver pour SQL Server. Si toutes les autres valeurs de paramètres sont valides, la table SQL Server est créée. |
| DBPROP_COL_FIXEDLENGTH | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server utilise DBPROP_COL_FIXEDLENGTH pour déterminer le mappage de type de données lorsque le consommateur définit le type de données d’une colonne au moyen du membre wType de la structure DBCOLUMNDESC. Pour plus d'informations, voir Mappage de types de données dans ITableDefinition. |
| DBPROP_COL_NULLABLE | R/W : Lecture/écriture Valeur par défaut : None Description : Lors de la création de la table, le pilote OLE DB pour SQL Server indique si la colonne doit accepter des valeurs NULL si la propriété est définie. Lorsque la propriété n'est pas définie, l'aptitude de la colonne à valider la valeur NULL dépend de l'option de base de données par défaut ANSI_NULLS de SQL Server. OLE DB Driver pour SQL Server est un fournisseur conforme ISO. Les sessions connectées affichent des comportements ISO. Si le consommateur ne définit pas DBPROP_COL_NULLABLE, les colonnes acceptent des valeurs NULL. |
| DBPROP_COL_PRIMARYKEY | R/W : Lecture/écriture Valeur par défaut : Description de VARIANT_FALSE : Lorsque la valeur définie est VARIANT_TRUE, le pilote OLE DB pour SQL Server crée la colonne avec une contrainte PRIMARY KEY. Si la propriété est définie comme une propriété de colonne, seule une colonne unique peut déterminer la contrainte. La définition de la propriété sur VARIANT_TRUE pour plusieurs colonnes uniques retourne une erreur quand le pilote OLE DB pour SQL Server tente de créer la table SQL Server. Remarque : Le consommateur peut faire appel à la fonction IIndexDefinition::CreateIndex pour créer une contrainte PRIMARY KEY dans deux ou plusieurs colonnes. Le pilote OLE DB pour SQL Server retourne DB_S_ERRORSOCCURRED lorsque DBPROP_COL_PRIMARYKEY et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et que la valeur dwOption de DBPROP_COL_UNIQUE n’est pas DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED est retourné lorsque DBPROP_COL_PRIMARYKEY et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et quand la valeur dwOption de DBPROP_COL_UNIQUE est égale à DBPROPOPTIONS_REQUIRED. La colonne est définie avec la propriété d’identité SQL Server et le membre dwStatus DBPROP_COL_PRIMARYKEY est défini sur DBPROPSTATUS_CONFLICTING. Le pilote OLE DB pour SQL Server retourne une erreur lorsque DBPROP_COL_PRIMARYKEY et DBPROP_COL_NULLABLE ont tous les deux la valeur VARIANT_TRUE. Le pilote OLE DB pour SQL Server retourne une erreur à partir de SQL Server lorsque le consommateur tente de créer une contrainte PRIMARY KEY dans une colonne de type de données SQL Server non valide. Vous ne pouvez pas définir des contraintes PRIMARY KEY dans des colonnes créées avec les types de données SQL Serverbit, text, ntext et image. |
| DBPROP_COL_UNIQUE | R/W : Lecture/écriture Valeur par défaut : Description de VARIANT_FALSE : Applique une contrainte SQL Server UNIQUE à la colonne. Si la propriété est définie comme une propriété de colonne, la contrainte est appliquée dans une seule colonne uniquement. Le consommateur peut se servir de la fonction IIndexDefinition::CreateIndex pour appliquer une contrainte UNIQUE à des valeurs combinées de deux ou plusieurs colonnes. Le pilote OLE DB pour SQL Server retourne DB_S_ERRORSOCCURRED lorsque DBPROP_COL_PRIMARYKEY et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et que la valeur dwOption n’est pas DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED est retourné lorsque DBPROP_COL_PRIMARYKEY et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et quand la valeur dwOption est égale à DBPROPOPTIONS_REQUIRED. La colonne est définie avec la propriété d’identité SQL Server et le membre dwStatus DBPROP_COL_PRIMARYKEY est défini sur DBPROPSTATUS_CONFLICTING. Le pilote OLE DB pour SQL Server retourne DB_S_ERRORSOCCURRED lorsque DBPROP_COL_NULLABLE et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et que la valeur dwOption n’est pas DBPROPOPTIONS_REQUIRED. DB_E_ERRORSOCCURRED est retourné lorsque DBPROP_COL_NULLABLE et DBPROP_COL_UNIQUE sont tous les deux définis sur VARIANT_TRUE et quand la valeur dwOption est égale à DBPROPOPTIONS_REQUIRED. La colonne est définie avec la propriété d’identité SQL Server et le membre dwStatus DBPROP_COL_NULLABLE est défini sur DBPROPSTATUS_CONFLICTING. Le pilote OLE DB pour SQL Server retourne une erreur à partir de SQL Server lorsque le consommateur tente de créer une contrainte UNIQUE dans une colonne de type de données SQL Server non valide. Vous ne pouvez pas définir des contraintes UNIQUE sur des colonnes créées avec le type de données SQL Server bit. |
Lorsque le consommateur appelle la fonction ITableDefinition::CreateTable, le pilote OLE DB pour SQL Server interprète les propriétés de la table de la manière suivante :
| ID de propriété | Description |
|---|---|
| DBPROP_TBL_TEMPTABLE | R/W : Lecture/écriture Valeur par défaut : Description de VARIANT_FALSE : Par défaut,OLE DB Driver pour SQL Server crée des tables nommées par le consommateur. Lorsque la valeur est VARIANT_TRUE, OLE DB Driver pour SQL Server génère un nom de table temporaire pour le consommateur. Le consommateur attribue la valeur NULL au paramètre pTableID de CreateTable. Le paramètre ppTableID doit contenir un pointeur valide. |
Si le consommateur nécessite l’ouverture d’un ensemble de lignes dans une table créée, le pilote OLE DB pour SQL Server ouvre un ensemble de lignes pris en charge par le curseur. Toutes les propriétés de l'ensemble de lignes peuvent être indiquées dans les jeux de propriétés passés.
L'exemple ci-dessous crée une table 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);
}
Voir aussi
Commentaires
Bientôt disponible : pendant toute l’année 2024, nous allons éliminer progressivement Problèmes GitHub comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, voir : https://aka.ms/ContentUserFeedback.
Soumettre et afficher des commentaires pour