SQL Server 테이블에 열 추가Adding a Column to a SQL Server Table

적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database 예Azure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance 예Azure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics 예병렬 데이터 웨어하우스Parallel Data Warehouseyes병렬 데이터 웨어하우스Parallel Data Warehouse적용 대상:Applies to: 예SQL ServerSQL Server(지원되는 모든 버전)yesSQL ServerSQL Server (all supported versions) 예Azure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database 예Azure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance 예Azure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics 예병렬 데이터 웨어하우스Parallel Data Warehouseyes병렬 데이터 웨어하우스Parallel Data Warehouse

다운로드OLE DB 드라이버 다운로드DownloadDownload OLE DB Driver

OLE DB Driver for SQL Server는 ITableDefinition::AddColumn 함수를 노출합니다.The OLE DB Driver for SQL Server exposes the ITableDefinition::AddColumn function. 소비자가 SQL ServerSQL Server 테이블에 열을 추가할 수 있습니다.This allows consumers to add a column to a SQL ServerSQL Server table.

SQL ServerSQL Server 테이블에 열을 추가하는 경우 OLE DB Driver for SQL Server 소비자는 다음과 같이 제한됩니다.When you add a column to a SQL ServerSQL Server table, the OLE DB Driver for SQL Server consumer is constrained as follows:

  • DBPROP_COL_AUTOINCREMENT가 VARIANT_TRUE이면 DBPROP_COL_NULLABLE은 VARIANT_FALSE여야 합니다.If DBPROP_COL_AUTOINCREMENT is VARIANT_TRUE, DBPROP_COL_NULLABLE must be VARIANT_FALSE.

  • SQL ServerSQL Servertimestamp 데이터 형식을 사용하여 열을 정의하는 경우 DBPROP_COL_NULLABLE은 VARIANT_FALSE여야 합니다.If the column is defined by using the SQL ServerSQL Server timestamp data type, DBPROP_COL_NULLABLE must be VARIANT_FALSE.

  • 다른 모든 열 정의에서 DBPROP_COL_NULLABLE은 VARIANT_TRUE여야 합니다.For any other column definition, DBPROP_COL_NULLABLE must be VARIANT_TRUE.

소비자는 pTableID 매개 변수에서 uName 공용 구조체의 pwszName 멤버에 테이블 이름을 유니코드 문자열로 지정합니다.Consumers specify the table name as a Unicode character string in the pwszName member of the uName union in the pTableID parameter. pTableIDeKind 멤버는 DBKIND_NAME이어야 합니다.The eKind member of pTableID must be DBKIND_NAME.

새로운 열 이름은 DBCOLUMNDESC 매개 변수 pColumnDescdbcid 멤버에 있는 uName 공용 구조체의 pwszName 멤버에서 유니코드 문자열로 지정됩니다.The new column name is specified as a Unicode character string in the pwszName member of the uName union in the dbcid member of the DBCOLUMNDESC parameter pColumnDesc. eKind 멤버는 DBKIND_NAME이어야 합니다.The eKind member must be DBKIND_NAME.

참고 항목See Also

테이블 및 인덱스 Tables and Indexes
ALTER TABLE(Transact-SQL)ALTER TABLE (Transact-SQL)