Returns a result set listing the tables and associated privileges in a
database.
Parameters
connection
A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.
qualifier
A qualifier for DB2 databases running on OS/390 or z/OS servers. For
other databases, pass NULL or an empty string.
schema
The schema which contains the tables. This parameter accepts a
search pattern containing _ and %
as wildcards.
table_name
The name of the table. This parameter accepts a search pattern
containing _ and % as wildcards.
Return Values
Returns a statement resource with a result set containing rows describing
the privileges for the tables that match the specified parameters. The rows
are composed of the following columns:
Column name
Description
TABLE_CAT
The catalog that contains the table. The value is NULL if
this table does not have catalogs.
TABLE_SCHEM
Name of the schema that contains the table.
TABLE_NAME
Name of the table.
GRANTOR
Authorization ID of the user who granted the privilege.
GRANTEE
Authorization ID of the user to whom the privilege was
granted.
PRIVILEGE
The privilege that has been granted. This can be one of ALTER,
CONTROL, DELETE, INDEX, INSERT, REFERENCES, SELECT, or UPDATE.
IS_GRANTABLE
A string value of "YES" or "NO" indicating whether the grantee
can grant the privilege to other users.