odbc_statistics

(PHP 4、PHP 5、PHP 7、PHP 8)

odbc_statistics — 检索有关表的信息

描述

odbc_statistics(
    Odbc\Connection $odbc,
    ?string $catalog,
    string $schema,
    string $table,
    int $unique,
    int $accuracy
): Odbc\Result|false

获取有关表及其索引的统计信息。

参数

odbc: ODBC 连接对象，有关详细信息，请参见 odbc_connect()。
catalog: 目录（在 ODBC 2 中称为“限定符”）。
schema: 模式（在 ODBC 2 中称为“所有者”）。
table: 表名。
unique: 索引的类型。SQL_INDEX_UNIQUE 或 SQL_INDEX_ALL 之一。
accuracy: SQL_ENSURE 或 SQL_QUICK 之一。后者请求驱动程序仅在服务器上随时可用时检索 CARDINALITY 和 PAGES。

返回值

如果成功则返回 ODBC 结果对象，如果失败则返回 false。

结果集包含以下列

TABLE_CAT
TABLE_SCHEM
TABLE_NAME
NON_UNIQUE
INDEX_QUALIFIER
INDEX_NAME
TYPE
ORDINAL_POSITION
COLUMN_NAME
ASC_OR_DESC
CARDINALITY
PAGES
FILTER_CONDITION

驱动程序可以报告其他列。

结果集按 NON_UNIQUE、TYPE、INDEX_QUALIFIER、INDEX_NAME 和 ORDINAL_POSITION 排序。

变更日志

版本	描述
8.4.0	`odbc` 现在期望一个 Odbc\Connection 实例；以前，期望一个 resource。
8.4.0	此函数现在返回一个 Odbc\Result 实例；以前，返回一个 resource。

范例

示例 #1 列出表的统计信息

<?php
$conn = odbc_connect($dsn, $user, $pass);
$statistics = odbc_statistics($conn, 'TutorialDB', 'dbo', 'TEST', SQL_INDEX_UNIQUE, SQL_QUICK);
while (($row = odbc_fetch_array($statistics))) {
 print_r($row);
 break; // 为简洁起见省略了其他行
}
?>

以上示例将输出类似以下内容

Array
(
    [TABLE_CAT] => TutorialDB
    [TABLE_SCHEM] => dbo
    [TABLE_NAME] => TEST
    [NON_UNIQUE] =>
    [INDEX_QUALIFIER] =>
    [INDEX_NAME] =>
    [TYPE] => 0
    [ORDINAL_POSITION] =>
    [COLUMN_NAME] =>
    [ASC_OR_DESC] =>
    [CARDINALITY] => 15
    [PAGES] => 3
    [FILTER_CONDITION] =>
)

参见

odbc_tables() - 获取存储在特定数据源中的表名列表

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 1 条注释

上移

下移

eion at bigfoot dot com ¶

13 年前

函数的一些参数未定义

unique - 确定您是否要仅返回唯一索引或所有索引。为此参数使用 SQL_INDEX_UNIQUE 或 SQL_INDEX_ALL

accuracy - 您是否要返回有关表的所有信息，或者仅返回 readily available 的信息。为此参数使用 SQL_ENSURE 或 SQL_QUICK

有关此函数的更多信息，请参阅 MSDN 上的 ODBC 函数 SQLStatistics()：http://msdn.microsoft.com/en-us/library/ms711022(v=vs.85).aspx

＋添加注释