PHP8 odbc_tables
(PHP 4、PHP 5、PHP 7、PHP 8)
odbc_tables — 获取存储在特定数据源中的表名列表
说明
odbc_tables(
resource $odbc,
?string $catalog = null,
?string $schema = null,
?string $table = null,
?string $types = null
): resource|false
列出请求范围内的所有表。
若要支持限定符、所有者和表类型的枚举, 提供 、 、 和 的以下特殊语义:catalogschematabletable_type
- 如果目录为单个百分比 字符 (%) 和 schema 和 table 是空字符串,则结果为 set 包含数据的有效限定符列表 源。(除 TABLE_QUALIFIER 列外的所有列都包含 NULL。
- 如果架构为百分之一字符 (%) 和 catalog 和 table 是空字符串,则结果为 set 包含数据源的有效所有者列表。(全部 除 TABLE_OWNER 列之外的列包含 NULL。
- 如果 table_type 为百分之一 字符 (%) 和 catalog、schema 和 table 是空字符串,则结果集包含 数据源的有效表类型。(除 TABLE_TYPE列包含 NULL。
参数
odbc
ODBC 连接标识符,详见 odbc_connect()。
catalog
目录(ODBC 2 用语中的“限定符”)。
schema
架构(ODBC 2 用语中的“owner”)。 此参数接受下列查询模式: 来匹配零到多个字符, 来匹配单个字符。
%
_
table
The name. 此参数接受下列查询模式: 来匹配零到多个字符, 来匹配单个字符。
%
_
types
如果不是空字符串,则 必须包含以下类型的逗号分隔值列表 利息;每个值可以用单引号 () 或 未加引号。例如,或 .如果 数据源不支持指定的表类型,odbc_tables() 不返回 那种类型。
table_type
'
'TABLE','VIEW'
TABLE, VIEW
返回值
返回包含以下信息的 ODBC 结果标识符 或者在失败时返回 false.
结果集包含以下列:
- TABLE_CAT
- TABLE_SCHEM
- TABLE_NAME
- TABLE_TYPE
- REMARKS
驱动程序可以报告其他列。
结果集按 、 和 排序。TABLE_TYPETABLE_CATTABLE_SCHEMTABLE_NAME
更新日志
版本 | 说明 |
---|---|
8.0.0 | schema ,现在是可为 null 的。table types |
示例
示例 #1 列出目录中的表
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
print_r($row);
break; // further rows omitted for brevity
}
?>
以上示例的输出类似于:
Array ( [TABLE_CAT] => SalesOrders [TABLE_SCHEM] => dbo [TABLE_NAME] => Orders [TABLE_TYPE] => TABLE [REMARKS] => )
参见
- odbc_tableprivileges() - 列出表以及与每个表关联的权限
- odbc_columns() - 列出指定表中的列名
- odbc_specialcolumns() - 检索特殊列
- odbc_statistics() - 检索有关表的统计信息
- odbc_procedures() - 获取存储在特定数据源中的过程列表