odbc_columnprivileges

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

odbc_columnprivileges — Перечисляет столбцы таблицы и привилегии, которые связаны со столбцами

Описание

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

Функция перечисляет столбцы таблицы и привилегии, которые связаны со столбцами.

Список параметров

odbc: Объект ODBC-соединения. Подробнее о коннекторе рассказывает описание функции odbc_connect().
catalog: Каталог ('qualifier' на языке ODBC 2).
schema: Схема ('owner' на языке ODBC 2). Параметр принимает следующие шаблоны поиска: %, который соответствует нулю или более символам, и _, который соответствует ровно одному символу.
table: Название таблицы. Параметр принимает следующие шаблоны поиска: %, который соответствует нулю или более символам, и _, который соответствует ровно одному символу.
column: Название столбца. Параметр принимает следующие шаблоны поиска: %, который соответствует нулю или более символам, и _, который соответствует ровно одному символу.

Возвращаемые значения

Функция возвращает объект ODBC с результатом или false, если возникла ошибка. Из этого объекта получают список столбцов и связанные привилегии.

В результирующем наборе содержатся следующие столбцы:

TABLE_CAT
TABLE_SCHEM
TABLE_NAME
COLUMN_NAME
GRANTOR
GRANTEE
PRIVILEGE
IS_GRANTABLE

Драйвер иногда сообщает о дополнительных столбцах.

Результирующий набор упорядочивается по столбцам TABLE_CAT, TABLE_SCHEM, TABLE_NAME, COLUMN_NAME и PRIVILEGE.

Список изменений

Версия	Описание
8.4.0	Параметр `odbc` теперь принимает объект соединения Odbc\Connection; раньше принимался тип resource.

Примеры

Пример #1 Пример перечисления привилегий столбца

<?php

$conn = odbc_connect($dsn, $user, $pass);

$privileges = odbc_columnprivileges($conn, 'TutorialDB', 'dbo', 'test', 'id');

while (($row = odbc_fetch_array($privileges))) {
    print_r($row);
    break; // Следующие строки опустили для краткости
}

?>

Вывод приведённого примера будет похож на:

Array
(
    [TABLE_CAT] => TutorialDB
    [TABLE_SCHEM] => dbo
    [TABLE_NAME] => test
    [COLUMN_NAME] => id
    [GRANTOR] => dbo
    [GRANTEE] => dbo
    [PRIVILEGE] => INSERT
    [IS_GRANTABLE] => YES
)