2024 日本 PHP 研討會

odbc_procedurecolumns

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_procedurecolumns擷取程序參數的相關資訊

說明

odbc_procedurecolumns(
    Odbc\Connection $odbc,
    ?字串 $catalog = null,
    (?string) $schema = null,
    (?string) $procedure = null,
    (?string) $column = null
): Odbc\Result|false

擷取預存程序參數的相關資訊。

參數

odbc

ODBC 連線物件,詳情請參閱 odbc_connect()

catalog

目錄(在 ODBC 2 術語中稱為「qualifier」)。

schema

綱要(在 ODBC 2 術語中稱為「owner」)。此參數接受以下搜尋模式:% 匹配零個或多個字元,_ 匹配單個字元。

procedure

預存程序。此參數接受以下搜尋模式:% 匹配零個或多個字元,_ 匹配單個字元。

column

欄位。此參數接受以下搜尋模式:% 匹配零個或多個字元,_ 匹配單個字元。

回傳值

傳回輸入和輸出參數的列表,以及組成指定預存程序結果集的欄位。成功時傳回 ODBC 結果物件,失敗時傳回 false

結果集包含以下欄位

  • PROCEDURE_CAT
  • PROCEDURE_SCHEM
  • PROCEDURE_NAME
  • COLUMN_NAME
  • COLUMN_TYPE
  • DATA_TYPE
  • TYPE_NAME
  • COLUMN_SIZE
  • BUFFER_LENGTH
  • DECIMAL_DIGITS
  • NUM_PREC_RADIX
  • NULLABLE
  • REMARKS
  • COLUMN_DEF
  • SQL_DATA_TYPE
  • SQL_DATETIME_SUB
  • CHAR_OCTET_LENGTH
  • ORDINAL_POSITION
  • IS_NULLABLE
驅動程式可能會回報其他欄位。

結果集依照 PROCEDURE_CATPROCEDURE_SCHEMPROCEDURE_NAMECOLUMN_TYPE 排序。

更新日誌

版本 說明
8.4.0 odbc 現在需要 Odbc\Connection 實例;先前需要的是 resource
8.4.0 此函式現在傳回 Odbc\Result 實例;先前傳回的是 resource
8.0.0 在此版本之前,該函式只能使用一個或五個參數呼叫。

範例

範例 #1 列出預存程序的欄位

<?php
$conn
= odbc_connect($dsn, $user, $pass);
$columns = odbc_procedurecolumns($conn, 'TutorialDB', 'dbo', 'GetEmployeeSalesYTD;1', '%');
while ((
$row = odbc_fetch_array($columns))) {
print_r($row);
break;
// 為求簡潔,省略後續列
}
?>

以上範例將輸出類似以下的內容

Array
(
    [PROCEDURE_CAT] => TutorialDB
    [PROCEDURE_SCHEM] => dbo
    [PROCEDURE_NAME] => GetEmployeeSalesYTD;1
    [COLUMN_NAME] => @SalesPerson
    [COLUMN_TYPE] => 1
    [DATA_TYPE] => -9
    [TYPE_NAME] => nvarchar
    [COLUMN_SIZE] => 50
    [BUFFER_LENGTH] => 100
    [DECIMAL_DIGITS] =>
    [NUM_PREC_RADIX] =>
    [NULLABLE] => 1
    [REMARKS] =>
    [COLUMN_DEF] =>
    [SQL_DATA_TYPE] => -9
    [SQL_DATETIME_SUB] =>
    [CHAR_OCTET_LENGTH] => 100
    [ORDINAL_POSITION] => 1
    [IS_NULLABLE] => YES
)

另請參閱

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top