mirror of
https://git.postgresql.org/git/postgresql.git
synced 2026-02-22 06:17:00 +08:00
e83d1b0c40
This commit introduces trigger on login event, allowing to fire some actions right on the user connection. This can be useful for logging or connection check purposes as well as for some personalization of environment. Usage details are described in the documentation included, but shortly usage is the same as for other triggers: create function returning event_trigger and then create event trigger on login event. In order to prevent the connection time overhead when there are no triggers the commit introduces pg_database.dathasloginevt flag, which indicates database has active login triggers. This flag is set by CREATE/ALTER EVENT TRIGGER command, and unset at connection time when no active triggers found. Author: Konstantin Knizhnik, Mikhail Gribkov Discussion: https://postgr.es/m/0d46d29f-4558-3af9-9c85-7774e14a7709%40postgrespro.ru Reviewed-by: Pavel Stehule, Takayuki Tsunakawa, Greg Nancarrow, Ivan Panchenko Reviewed-by: Daniel Gustafsson, Teodor Sigaev, Robert Haas, Andres Freund Reviewed-by: Tom Lane, Andrey Sokolov, Zhihong Yu, Sergey Shinderuk Reviewed-by: Gregory Stark, Nikita Malakhov, Ted Yu
128 lines
3.5 KiB
C
128 lines
3.5 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* pg_database.h
|
|
* definition of the "database" system catalog (pg_database)
|
|
*
|
|
*
|
|
* Portions Copyright (c) 1996-2023, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/catalog/pg_database.h
|
|
*
|
|
* NOTES
|
|
* The Catalog.pm module reads this file and derives schema
|
|
* information.
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef PG_DATABASE_H
|
|
#define PG_DATABASE_H
|
|
|
|
#include "catalog/genbki.h"
|
|
#include "catalog/pg_database_d.h"
|
|
|
|
/* ----------------
|
|
* pg_database definition. cpp turns this into
|
|
* typedef struct FormData_pg_database
|
|
* ----------------
|
|
*/
|
|
CATALOG(pg_database,1262,DatabaseRelationId) BKI_SHARED_RELATION BKI_ROWTYPE_OID(1248,DatabaseRelation_Rowtype_Id) BKI_SCHEMA_MACRO
|
|
{
|
|
/* oid */
|
|
Oid oid;
|
|
|
|
/* database name */
|
|
NameData datname;
|
|
|
|
/* owner of database */
|
|
Oid datdba BKI_DEFAULT(POSTGRES) BKI_LOOKUP(pg_authid);
|
|
|
|
/* character encoding */
|
|
int32 encoding;
|
|
|
|
/* locale provider, see pg_collation.collprovider */
|
|
char datlocprovider;
|
|
|
|
/* allowed as CREATE DATABASE template? */
|
|
bool datistemplate;
|
|
|
|
/* new connections allowed? */
|
|
bool datallowconn;
|
|
|
|
/* database has login event triggers? */
|
|
bool dathasloginevt;
|
|
|
|
/*
|
|
* Max connections allowed. Negative values have special meaning, see
|
|
* DATCONNLIMIT_* defines below.
|
|
*/
|
|
int32 datconnlimit;
|
|
|
|
/* all Xids < this are frozen in this DB */
|
|
TransactionId datfrozenxid;
|
|
|
|
/* all multixacts in the DB are >= this */
|
|
TransactionId datminmxid;
|
|
|
|
/* default table space for this DB */
|
|
Oid dattablespace BKI_LOOKUP(pg_tablespace);
|
|
|
|
#ifdef CATALOG_VARLEN /* variable-length fields start here */
|
|
/* LC_COLLATE setting */
|
|
text datcollate BKI_FORCE_NOT_NULL;
|
|
|
|
/* LC_CTYPE setting */
|
|
text datctype BKI_FORCE_NOT_NULL;
|
|
|
|
/* ICU locale ID */
|
|
text daticulocale;
|
|
|
|
/* ICU collation rules */
|
|
text daticurules;
|
|
|
|
/* provider-dependent version of collation data */
|
|
text datcollversion BKI_DEFAULT(_null_);
|
|
|
|
/* access permissions */
|
|
aclitem datacl[1];
|
|
#endif
|
|
} FormData_pg_database;
|
|
|
|
/* ----------------
|
|
* Form_pg_database corresponds to a pointer to a tuple with
|
|
* the format of pg_database relation.
|
|
* ----------------
|
|
*/
|
|
typedef FormData_pg_database *Form_pg_database;
|
|
|
|
DECLARE_TOAST_WITH_MACRO(pg_database, 4177, 4178, PgDatabaseToastTable, PgDatabaseToastIndex);
|
|
|
|
DECLARE_UNIQUE_INDEX(pg_database_datname_index, 2671, DatabaseNameIndexId, pg_database, btree(datname name_ops));
|
|
DECLARE_UNIQUE_INDEX_PKEY(pg_database_oid_index, 2672, DatabaseOidIndexId, pg_database, btree(oid oid_ops));
|
|
|
|
/*
|
|
* pg_database.dat contains an entry for template1, but not for the template0
|
|
* or postgres databases, because those are created later in initdb.
|
|
* However, we still want to manually assign the OIDs for template0 and
|
|
* postgres, so declare those here.
|
|
*/
|
|
DECLARE_OID_DEFINING_MACRO(Template0DbOid, 4);
|
|
DECLARE_OID_DEFINING_MACRO(PostgresDbOid, 5);
|
|
|
|
/*
|
|
* Special values for pg_database.datconnlimit. Normal values are >= 0.
|
|
*/
|
|
#define DATCONNLIMIT_UNLIMITED -1 /* no limit */
|
|
|
|
/*
|
|
* A database is set to invalid partway through being dropped. Using
|
|
* datconnlimit=-2 for this purpose isn't particularly clean, but is
|
|
* backpatchable.
|
|
*/
|
|
#define DATCONNLIMIT_INVALID_DB -2
|
|
|
|
extern bool database_is_invalid_form(Form_pg_database datform);
|
|
extern bool database_is_invalid_oid(Oid dboid);
|
|
|
|
#endif /* PG_DATABASE_H */
|