分享方式：

其他數據表值參數元數據

  • 文章

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW）

若要擷取數據表值參數的元數據，應用程式會呼叫 SQLProcedureColumns。 針對數據表值參數，SQLProcedureColumns 會傳回單一數據列。 已新增兩個額外的 SQL Server 特定數據行，SS_TYPE_CATALOG_NAME和SS_TYPE_SCHEMA_NAME，以提供與數據表值參數相關聯之數據表類型的架構和目錄資訊。 與 ODBC 規格一致，SS_TYPE_CATALOG_NAME和SS_TYPE_SCHEMA_NAME會出現在舊版 SQL Server 中新增的所有驅動程式特定數據行之前，以及 ODBC 本身所授權的所有數據行之後。

下表列出對數據表值參數而言很重要的數據行。

資料行名稱 資料類型 值/註解
DATA_TYPE Smallint not NULL SQL_SS_TABLE
TYPE_NAME WVarchar（128） 非 NULL 數據表值參數的類型名稱。
COLUMN_SIZE 整數 NULL
BUFFER_LENGTH 整數 0
DECIMAL_DIGITS Smallint NULL
NUM_PREC_RADIX Smallint NULL
NULLABLE Smallint not NULL SQL_NULLABLE
REMARKS Varchar NULL
COLUMN_DEF WVarchar（4000） NULL
SQL_DATA_TYPE Smallint not NULL SQL_SS_TABLE
SQL_DATETIME_SUB Smallint NULL
CHAR_OCTET_LENGTH 整數 NULL
ORDINAL_POSITION 整數不是 NULL 參數的序數位置。
IS_NULLABLE Varchar “YES”
SS_TYPE_CATALOG_NAME WVarchar（128） 非 NULL 目錄，其中包含數據表值參數之數據表類型的類型定義。
SS_TYPE_SCHEMA_NAME WVarchar（128） 非 NULL 架構，其中包含數據表值參數之數據表類型的型別定義。

WVarchar 數據行在 ODBC 規格中定義為 Varchar，但實際上會在最近所有 SQL Server ODBC 驅動程式中傳回為 WVarchar。 當 Unicide 支援新增至 ODBC 3.5 規格，但未明確呼叫時，就會進行這項變更。

若要取得數據表值參數的其他元數據，應用程式會使用目錄函式 SQLColumns 和 SQLPrimaryKeys。 針對數據表值參數呼叫這些函式之前，應用程式必須將語句屬性SQL_SOPT_SS_NAME_SCOPE設定為SQL_SS_NAME_SCOPE_TABLE_TYPE。 這個值表示應用程式需要數據表類型的元數據，而不是實際的數據表。 然後，應用程式會將數據表值參數的TYPE_NAME傳遞為 TableName 參數。 SS_TYPE_CATALOG_NAME和SS_TYPE_SCHEMA_NAME分別與 CatalogName 和 SchemaName 參數搭配使用，以識別數據表值參數的目錄和架構。 當應用程式完成擷取資料表值參數的元數據時，必須將SQL_SOPT_SS_NAME_SCOPE設定回其預設值SQL_SS_NAME_SCOPE_TABLE。

當SQL_SOPT_SS_NAME_SCOPE設定為SQL_SS_NAME_SCOPE_TABLE時，鏈接伺服器的查詢會失敗。 使用包含伺服器元件的目錄呼叫 SQLColumns 或 SQLPrimaryKeys 將會失敗。

另請參閱

資料表值參數 （ODBC）