PHP: Hypertext Preprocessor (original) (raw)

odbc_tableprivileges

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

odbc_tableprivileges — Lists tables and the privileges associated with each table

Description

odbc_tableprivileges(
Odbc\Connection $odbc,
?string $catalog,
string $schema,
string $table
): Odbc\Result|false

Parameters

odbc

The ODBC connection object, see odbc_connect() for details.

catalog

The catalog ('qualifier' in ODBC 2 parlance).

schema

The schema ('owner' in ODBC 2 parlance). This parameter accepts the following search patterns:% to match zero or more characters, and _ to match a single character.

table

The name. This parameter accepts the following search patterns:% to match zero or more characters, and _ to match a single character.

Return Values

Returns an ODBC result object or [false](reserved.constants.php#constant.false) on failure.

The result set has the following columns:

TABLE_CAT
TABLE_SCHEM
TABLE_NAME
GRANTOR
GRANTEE
PRIVILEGE
IS_GRANTABLE

Drivers can report additional columns.

The result set is ordered by TABLE_CAT, TABLE_SCHEM,TABLE_NAME, PRIVILEGE and GRANTEE.

Changelog

Version	Description
8.4.0	odbc expects an Odbc\Connection instance now; previously, a resource was expected.
8.4.0	This function returns an Odbc\Result instance now; previously, a resource was returned.

Examples

Example #1 List Privileges of a Table

<?php <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>c</mi><mi>o</mi><mi>n</mi><mi>n</mi><mo>=</mo><mi>o</mi><mi>d</mi><mi>b</mi><msub><mi>c</mi><mi>c</mi></msub><mi>o</mi><mi>n</mi><mi>n</mi><mi>e</mi><mi>c</mi><mi>t</mi><mo stretchy="false">(</mo></mrow><annotation encoding="application/x-tex">conn = odbc_connect(</annotation></semantics></math>conn=odbcconnect(dsn, <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>u</mi><mi>s</mi><mi>e</mi><mi>r</mi><mo separator="true">,</mo></mrow><annotation encoding="application/x-tex">user, </annotation></semantics></math>user,pass); <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>g</mi><mi>e</mi><mi>s</mi><mo>=</mo><mi>o</mi><mi>d</mi><mi>b</mi><msub><mi>c</mi><mi>t</mi></msub><mi>a</mi><mi>b</mi><mi>l</mi><mi>e</mi><mi>p</mi><mi>r</mi><mi>i</mi><mi>v</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>g</mi><mi>e</mi><mi>s</mi><mo stretchy="false">(</mo></mrow><annotation encoding="application/x-tex">privileges = odbc_tableprivileges(</annotation></semantics></math>privileges=odbctableprivileges(conn, 'SalesOrders', 'dbo', 'Orders'); while (($row = odbc_fetch_array($privileges))) { print_r($row); break; // further rows omitted for brevity } ?>

The above example will output something similar to:

Array ( [TABLE_CAT] => SalesOrders [TABLE_SCHEM] => dbo [TABLE_NAME] => Orders [GRANTOR] => dbo [GRANTEE] => dbo [PRIVILEGE] => DELETE [IS_GRANTABLE] => YES )