mirror of
https://github.com/postgres/postgres.git
synced 2026-02-28 20:30:45 -05:00
a2e35b53c3
The changed routines are mostly those that can be directly called by
ProcessUtilitySlow; the intention is to make the affected object
information more precise, in support for future event trigger changes.
Originally it was envisioned that the OID of the affected object would
be enough, and in most cases that is correct, but upon actually
implementing the event trigger changes it turned out that ObjectAddress
is more widely useful.
Additionally, some command execution routines grew an output argument
that's an object address which provides further info about the executed
command. To wit:
* for ALTER DOMAIN / ADD CONSTRAINT, it corresponds to the address of
the new constraint
* for ALTER OBJECT / SET SCHEMA, it corresponds to the address of the
schema that originally contained the object.
* for ALTER EXTENSION {ADD, DROP} OBJECT, it corresponds to the address
of the object added to or dropped from the extension.
There's no user-visible change in this commit, and no functional change
either.
Discussion: 20150218213255.GC6717@tamriel.snowman.net
Reviewed-By: Stephen Frost, Andres Freund
77 lines
2.7 KiB
C
77 lines
2.7 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* objectaddress.h
|
|
* functions for working with object addresses
|
|
*
|
|
* Portions Copyright (c) 1996-2015, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/catalog/objectaddress.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef OBJECTADDRESS_H
|
|
#define OBJECTADDRESS_H
|
|
|
|
#include "nodes/pg_list.h"
|
|
#include "storage/lock.h"
|
|
#include "utils/acl.h"
|
|
#include "utils/relcache.h"
|
|
|
|
/*
|
|
* An ObjectAddress represents a database object of any type.
|
|
*/
|
|
typedef struct ObjectAddress
|
|
{
|
|
Oid classId; /* Class Id from pg_class */
|
|
Oid objectId; /* OID of the object */
|
|
int32 objectSubId; /* Subitem within object (eg column), or 0 */
|
|
} ObjectAddress;
|
|
|
|
extern const ObjectAddress InvalidObjectAddress;
|
|
|
|
#define ObjectAddressSubSet(addr, class_id, object_id, object_sub_id) \
|
|
do { \
|
|
(addr).classId = (class_id); \
|
|
(addr).objectId = (object_id); \
|
|
(addr).objectSubId = (object_sub_id); \
|
|
} while (0)
|
|
|
|
#define ObjectAddressSet(addr, class_id, object_id) \
|
|
ObjectAddressSubSet(addr, class_id, object_id, 0)
|
|
|
|
extern ObjectAddress get_object_address(ObjectType objtype, List *objname,
|
|
List *objargs, Relation *relp,
|
|
LOCKMODE lockmode, bool missing_ok);
|
|
|
|
extern void check_object_ownership(Oid roleid,
|
|
ObjectType objtype, ObjectAddress address,
|
|
List *objname, List *objargs, Relation relation);
|
|
|
|
extern Oid get_object_namespace(const ObjectAddress *address);
|
|
|
|
extern bool is_objectclass_supported(Oid class_id);
|
|
extern Oid get_object_oid_index(Oid class_id);
|
|
extern int get_object_catcache_oid(Oid class_id);
|
|
extern int get_object_catcache_name(Oid class_id);
|
|
extern AttrNumber get_object_attnum_name(Oid class_id);
|
|
extern AttrNumber get_object_attnum_namespace(Oid class_id);
|
|
extern AttrNumber get_object_attnum_owner(Oid class_id);
|
|
extern AttrNumber get_object_attnum_acl(Oid class_id);
|
|
extern AclObjectKind get_object_aclkind(Oid class_id);
|
|
extern bool get_object_namensp_unique(Oid class_id);
|
|
|
|
extern HeapTuple get_catalog_object_by_oid(Relation catalog,
|
|
Oid objectId);
|
|
|
|
extern char *getObjectDescription(const ObjectAddress *object);
|
|
extern char *getObjectDescriptionOids(Oid classid, Oid objid);
|
|
|
|
extern int read_objtype_from_string(const char *objtype);
|
|
extern char *getObjectTypeDescription(const ObjectAddress *object);
|
|
extern char *getObjectIdentity(const ObjectAddress *address);
|
|
extern char *getObjectIdentityParts(const ObjectAddress *address,
|
|
List **objname, List **objargs);
|
|
extern ArrayType *strlist_to_textarray(List *list);
|
|
|
|
#endif /* OBJECTADDRESS_H */
|