2024 年 PHP Conference Japan

pg_meta_data

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_meta_data 取得資料表的詮釋資料

說明

pg_meta_data(PgSql\Connection $connection, string $table_name, bool $extended = false): array|false

pg_meta_data() 會以陣列形式傳回 table_name 的表格定義。

參數

connection

一個 PgSql\Connection 實例。

table_name

表格的名稱。

extended

用於傳回擴展元資料的旗標。預設為 false

傳回值

一個包含表格定義的 陣列,如果失敗則傳回 false

更新日誌

版本 說明
8.1.0 connection 參數現在需要一個 PgSql\Connection 實例;先前需要的是一個 資源

範例

範例 #1 取得表格元資料

<?php
$dbconn
= pg_connect("dbname=publisher") or die("無法連線");

$meta = pg_meta_data($dbconn, 'authors');
if (
is_array($meta)) {
echo
'<pre>';
var_dump($meta);
echo
'</pre>';
}
?>

以上範例將輸出

array(3) {
["author"]=>
array(5) {
  ["num"]=>
  int(1)
  ["type"]=>
  string(7) "varchar"
  ["len"]=>
  int(-1)
  ["not null"]=>
  bool(false)
  ["has default"]=>
  bool(false)
}
["year"]=>
array(5) {
  ["num"]=>
  int(2)
  ["type"]=>
  string(4) "int2"
  ["len"]=>
  int(2)
  ["not null"]=>
  bool(false)
  ["has default"]=>
  bool(false)
}
["title"]=>
array(5) {
  ["num"]=>
  int(3)
  ["type"]=>
  string(7) "varchar"
  ["len"]=>
  int(-1)
  ["not null"]=>
  bool(false)
  ["has default"]=>
  bool(false)
}
}

參見

  • pg_convert() - 將關聯式陣列值轉換成適用於 SQL 陳述式的格式

新增註釋

使用者貢獻的註釋 6 則註釋

yarnofmoo at gmail dot com
17 年前
您可以使用以下查詢取得一些可能更有用的資訊

SELECT table_name, column_name, data_type, character_maximum_length FROM information_schema.columns WHERE table_name='tablename';
shaman_master at list dot ru
5 年前
如果參數 $extended 不是 false
<?php
array (大小 = 2)
'name' =>
array (
大小 = 11)
'num' => int 1
'type' => 字串 'varchar' (長度 = 7)
'len' => int -1
'not null' => 布林值 false
'has default' => 布林值 true
'array dims' => int 0
'is enum' => 布林值 false
'is base' => 布林值 true
'is composite' => 布林值 false
'is pesudo' => 布林值 false
'description' => 字串 '' (長度 = 0)
'id' =>
array (
大小 = 11)
'num' => int 2
'type' => 字串 'int4' (長度 = 4)
'len' => int 4
'not null' => 布林值 true
'has default' => 布林值 true
'array dims' => int 0
'is enum' => 布林值 false
'is base' => 布林值 true
'is composite' => 布林值 false
'is pesudo' => 布林值 false
'description' => 字串 '' (長度 = 0)
?>
Hayley Watson
7 年前
要指定綱要以及表格名稱,請照常使用 PostgreSQL 和此擴充功能中其他函數的「綱要名稱.表格名稱」格式。 當然,如果沒有前綴,則會使用預設的綱要搜尋路徑。

<?php
$meta
= pg_meta_data($dbconn, 'foo.bar'); // 綱要 "foo" 中的表格 "bar"
if (is_array($meta)) {
var_dump($meta);
}
?>
dmiller at NOSPAM dot judcom dot nsw dot gov dot au
21 年前
這個函式在處理資料表名稱 (tablename) 時似乎區分大小寫 (php-4.3.1)

返回的陣列結構如下:
['欄位名稱'] => 陣列
(
['num'] => 欄位編號,從 1 開始
['type'] => 資料類型,例如 varchar、int4
['len'] => 欄位的內部儲存大小。-1 表示可變長度
['not null'] => 布林值
['has default'] => 布林值
)
......

對於可變長度資料類型(varchar、text 等)
您可以從系統資料表 pg_attribute.atttypmod - 4 取得最大資料長度
例如:
select attnum, attname , atttypmod - 4 as field_len
from pg_attribute, pg_class
where relname='$tablename'
and attrelid=relfilenode
and attnum>=1
rburghol at vt dot edu
19 年前
當查詢暫存資料表的詮釋資料時,即使建立新的連線且暫存資料表已不存在,詮釋資料似乎仍然存在。

例如,如果您建立連線和暫存資料表,如下所示
$dbconn1 = pg_connect('blah blah', , PGSQL_CONNECT_FORCE_NEW);
pg_exec($dbconn1,'create temp table foo as select 'foo' as namecol, 'bar' as valcol');

然後建立新的連線

$dbconn2 = pg_connect('blah blah', , PGSQL_CONNECT_FORCE_NEW);

並在此新連線中查詢資料表 'foo' 的詮釋資料,它會回報此資料表的相關資訊
pg_meta_data($dbconn2,'foo');

"'Array ( [foo] => Array ( [num] => 1 [type] => varchar... "

然而,嘗試刪除此資料表
pg_exec($dbconn,'drop table foo');

會擲出錯誤
pg_exec(): 查詢失敗: 錯誤: 資料表 "foo" 不存在於 ...
jsnell at e-normous dot com
17 年前
內建函式不提供任何選取綱要 (schema) 的支援。如果您需要綱要支援,且不想更改 SEARCH_PATH,可以使用以下函式:

function meta_data($table, $schema = 'public')
{
$result = pg_query_params("SELECT a.attname, a.attnum, t.typname, a.attlen, a.attnotNULL, a.atthasdef, a.attndims
FROM pg_class as c, pg_attribute a, pg_type t, pg_namespace n
WHERE a.attnum > 0
AND a.attrelid = c.oid
AND c.relname = $1
AND a.atttypid = t.oid
AND n.oid = c.relnamespace
AND n.nspname = $2
ORDER BY a.attnum", array($table, $schema));
$fields = array();
while($row = pg_fetch_array()) {
$fields['attname'] = $row;
}
return $fields;
}
To Top