GET DESCRIPTOR · PostgreSQL 中文文檔 9.3

# GET DESCRIPTOR ## Name GET DESCRIPTOR?--?從SQL標識符區域獲得信息 ## Synopsis ``` GET DESCRIPTOR _descriptor_name_ _:cvariable_ = _descriptor_header_item_ [, ... ] GET DESCRIPTOR _descriptor_name_ VALUE _column_number_ _:cvariable_ = _descriptor_item_ [, ... ] ``` ## 描述 `GET DESCRIPTOR`從SQL描述符區域檢索關于查詢結果集的信息，并且將它存儲到宿主變量中。在使用該命令將信息傳遞給宿主語言變量之前通常使用`FETCH`或者`SELECT` 填充標識符區域。該命令有兩種形式：第一個形式檢索描述符"頭部"項，適用于作為整體的結果集。第二個形式需要作為額外參數的列數檢索關于特定列的信息。例子是列名和實際列值。 ## 參數 `_descriptor_name_` 描述符名字。 `_descriptor_header_item_` 一個標記識別檢索的頭部信息項。目前僅僅支持`COUNT` 可以獲取結果集中的列數。 `_column_number_` 關于被檢索的列數信息。計數從1開始。 `_descriptor_item_` 一個標記識別檢索列的信息項。參閱[Section 33.7.1](#calibre_link-2008) 獲取可支持項的列數。 `_cvariable_` 宿主變量將接收從描述符區域檢索的數據。 ## 例子檢索結果集中列數的例子： ``` EXEC SQL GET DESCRIPTOR d :d_count = COUNT; ``` 在第一列中檢索數據長度的例子： ``` EXEC SQL GET DESCRIPTOR d VALUE 1 :d_returned_octet_length = RETURNED_OCTET_LENGTH; ``` 檢索作為字符串第二列的數據主體的例子： ``` EXEC SQL GET DESCRIPTOR d VALUE 2 :d_data = DATA; ``` 這是一個執行`SELECT current_database();`的整個程序的例子，并且顯示了列數，列數據長度和列數據： ``` int main(void) { EXEC SQL BEGIN DECLARE SECTION; int d_count; char d_data[1024]; int d_returned_octet_length; EXEC SQL END DECLARE SECTION; EXEC SQL CONNECT TO testdb AS con1 USER testuser; EXEC SQL ALLOCATE DESCRIPTOR d; /*聲明，打開游標，并且分配描述符給游標 */ EXEC SQL DECLARE cur CURSOR FOR SELECT current_database(); EXEC SQL OPEN cur; EXEC SQL FETCH NEXT FROM cur INTO SQL DESCRIPTOR d; /*得到總列數*/ EXEC SQL GET DESCRIPTOR d :d_count = COUNT; printf("d_count = %d\n", d_count); /* 得到返回列的長度 */ EXEC SQL GET DESCRIPTOR d VALUE 1 :d_returned_octet_length = RETURNED_OCTET_LENGTH; printf("d_returned_octet_length = %d\n", d_returned_octet_length); /*讀取返回列作為字符串*/ EXEC SQL GET DESCRIPTOR d VALUE 1 :d_data = DATA; printf("d_data = %s\n", d_data); /*關閉*/ EXEC SQL CLOSE cur; EXEC SQL COMMIT; EXEC SQL DEALLOCATE DESCRIPTOR d; EXEC SQL DISCONNECT ALL; return 0; } ``` 當執行該例子的時候，結果看起來像這樣： ``` d_count = 1 d_returned_octet_length = 6 d_data = testdb ``` ## 兼容性在SQL標準中指定`GET DESCRIPTOR`。 ## 參見 [ALLOCATE DESCRIPTOR](#calibre_link-28), [SET DESCRIPTOR](#calibre_link-651)