/*------------------------------------------------------------------------- * * deparse_database_stmts.c * * All routines to deparse database statements. * * Copyright (c), Citus Data, Inc. * *------------------------------------------------------------------------- */ #include "postgres.h" #include "pg_version_compat.h" #include "catalog/namespace.h" #include "lib/stringinfo.h" #include "nodes/parsenodes.h" #include "utils/builtins.h" #include "commands/defrem.h" #include "distributed/deparser.h" #include "distributed/citus_ruleutils.h" #include "distributed/deparser.h" #include "distributed/listutils.h" #include "distributed/log_utils.h" #include "parser/parse_type.h" static void AppendAlterDatabaseOwnerStmt(StringInfo buf, AlterOwnerStmt *stmt); static void AppendAlterDatabaseStmt(StringInfo buf, AlterDatabaseStmt *stmt); static void AppendDefElemConnLimit(StringInfo buf, DefElem *def); const DefElemOptionFormat create_database_option_formats[] = { { "owner", " OWNER %s", OPTION_FORMAT_STRING }, { "template", " TEMPLATE %s", OPTION_FORMAT_STRING }, { "encoding", " ENCODING %s", OPTION_FORMAT_LITERAL_CSTR }, { "strategy", " STRATEGY %s", OPTION_FORMAT_LITERAL_CSTR }, { "locale", " LOCALE %s", OPTION_FORMAT_LITERAL_CSTR }, { "lc_collate", " LC_COLLATE %s", OPTION_FORMAT_LITERAL_CSTR }, { "lc_ctype", " LC_CTYPE %s", OPTION_FORMAT_LITERAL_CSTR }, { "icu_locale", " ICU_LOCALE %s", OPTION_FORMAT_LITERAL_CSTR }, { "icu_rules", " ICU_RULES %s", OPTION_FORMAT_LITERAL_CSTR }, { "locale_provider", " LOCALE_PROVIDER %s", OPTION_FORMAT_LITERAL_CSTR }, { "collation_version", " COLLATION_VERSION %s", OPTION_FORMAT_LITERAL_CSTR }, { "tablespace", " TABLESPACE %s", OPTION_FORMAT_STRING }, { "allow_connections", " ALLOW_CONNECTIONS %s", OPTION_FORMAT_BOOLEAN }, { "connection_limit", " CONNECTION LIMIT %d", OPTION_FORMAT_INTEGER }, { "is_template", " IS_TEMPLATE %s", OPTION_FORMAT_BOOLEAN }, { "oid", " OID %d", OPTION_FORMAT_OBJECT_ID } }; /* * DeparseAlterDatabaseOwnerStmt * Deparse an AlterDatabaseOwnerStmt node * * This function is responsible for producing a string representation of an * AlterDatabaseOwnerStmt node, which represents an ALTER DATABASE statement * that changes the owner of a database. The output string includes the ALTER * DATABASE keyword, the name of the database being altered, and the new owner * of the database. * * Parameters: * - node: a pointer to the AlterDatabaseOwnerStmt node to be deparsed * * Returns: * - a string representation of the ALTER DATABASE statement */ char * DeparseAlterDatabaseOwnerStmt(Node *node) { AlterOwnerStmt *stmt = castNode(AlterOwnerStmt, node); StringInfoData str = { 0 }; initStringInfo(&str); Assert(stmt->objectType == OBJECT_DATABASE); AppendAlterDatabaseOwnerStmt(&str, stmt); return str.data; } /* * * AppendAlterDatabaseOwnerStmt * Append an ALTER DATABASE statement for changing the owner of a database to the given StringInfo buffer. * * Parameters: * - buf: The StringInfo buffer to append the statement to. * - stmt: The AlterOwnerStmt representing the ALTER DATABASE statement to append. */ static void AppendAlterDatabaseOwnerStmt(StringInfo buf, AlterOwnerStmt *stmt) { Assert(stmt->objectType == OBJECT_DATABASE); appendStringInfo(buf, "ALTER DATABASE %s OWNER TO %s;", quote_identifier(strVal((String *) stmt->object)), RoleSpecString(stmt->newowner, true)); } static void AppendGrantDatabases(StringInfo buf, GrantStmt *stmt) { ListCell *cell = NULL; appendStringInfo(buf, " ON DATABASE "); foreach(cell, stmt->objects) { char *database = strVal(lfirst(cell)); appendStringInfoString(buf, quote_identifier(database)); if (cell != list_tail(stmt->objects)) { appendStringInfo(buf, ", "); } } } static void AppendGrantOnDatabaseStmt(StringInfo buf, GrantStmt *stmt) { Assert(stmt->objtype == OBJECT_DATABASE); AppendGrantSharedPrefix(buf, stmt); AppendGrantDatabases(buf, stmt); AppendGrantSharedSuffix(buf, stmt); } static void AppendDefElemConnLimit(StringInfo buf, DefElem *def) { appendStringInfo(buf, " CONNECTION LIMIT %ld", (long int) defGetNumeric(def)); } static void AppendAlterDatabaseStmt(StringInfo buf, AlterDatabaseStmt *stmt) { appendStringInfo(buf, "ALTER DATABASE %s ", quote_identifier(stmt->dbname)); if (stmt->options) { ListCell *cell = NULL; appendStringInfo(buf, "WITH "); foreach(cell, stmt->options) { DefElem *def = castNode(DefElem, lfirst(cell)); if (strcmp(def->defname, "is_template") == 0) { appendStringInfo(buf, "IS_TEMPLATE %s", quote_literal_cstr(strVal(def->arg))); } else if (strcmp(def->defname, "connection_limit") == 0) { AppendDefElemConnLimit(buf, def); } else if (strcmp(def->defname, "allow_connections") == 0) { ereport(ERROR, errmsg("ALLOW_CONNECTIONS is not supported")); } else { ereport(ERROR, errmsg("unrecognized ALTER DATABASE option: %s", def->defname)); } } } appendStringInfo(buf, ";"); } char * DeparseGrantOnDatabaseStmt(Node *node) { GrantStmt *stmt = castNode(GrantStmt, node); Assert(stmt->objtype == OBJECT_DATABASE); StringInfoData str = { 0 }; initStringInfo(&str); AppendGrantOnDatabaseStmt(&str, stmt); return str.data; } char * DeparseAlterDatabaseStmt(Node *node) { AlterDatabaseStmt *stmt = castNode(AlterDatabaseStmt, node); StringInfoData str = { 0 }; initStringInfo(&str); AppendAlterDatabaseStmt(&str, stmt); return str.data; } #if PG_VERSION_NUM >= PG_VERSION_15 char * DeparseAlterDatabaseRefreshCollStmt(Node *node) { AlterDatabaseRefreshCollStmt *stmt = (AlterDatabaseRefreshCollStmt *) node; StringInfoData str; initStringInfo(&str); appendStringInfo(&str, "ALTER DATABASE %s REFRESH COLLATION VERSION;", quote_identifier( stmt->dbname)); return str.data; } #endif static void AppendAlterDatabaseSetStmt(StringInfo buf, AlterDatabaseSetStmt *stmt) { appendStringInfo(buf, "ALTER DATABASE %s", quote_identifier(stmt->dbname)); VariableSetStmt *varSetStmt = castNode(VariableSetStmt, stmt->setstmt); AppendVariableSet(buf, varSetStmt); } char * DeparseAlterDatabaseSetStmt(Node *node) { AlterDatabaseSetStmt *stmt = castNode(AlterDatabaseSetStmt, node); StringInfoData str = { 0 }; initStringInfo(&str); AppendAlterDatabaseSetStmt(&str, stmt); return str.data; } /* * Validates for if option is template, lc_type, locale or lc_collate, propagation will * not be supported since template and strategy options are not stored in the catalog * and lc_type, locale and lc_collate options depends on template parameter. */ static void ValidateCreateDatabaseOptions(DefElem *option) { if (strcmp(option->defname, "template") == 0 || strcmp(option->defname, "strategy") == 0 || strcmp(option->defname, "lc_ctype") == 0 || strcmp(option->defname, "locale") == 0 || strcmp(option->defname, "lc_collate") == 0 || strcmp(option->defname, "icu_locale") == 0 || strcmp(option->defname, "locale_provider") == 0) { ereport(ERROR, errmsg("CREATE DATABASE option \"%s\" is not supported", option->defname)); } } /* * Prepares a CREATE DATABASE statement with given empty StringInfo buffer and CreatedbStmt node. */ static void AppendCreateDatabaseStmt(StringInfo buf, CreatedbStmt *stmt) { appendStringInfo(buf, "CREATE DATABASE %s", quote_identifier(stmt->dbname)); DefElem *option = NULL; foreach_ptr(option, stmt->options) { ValidateCreateDatabaseOptions(option); DefElemOptionToStatement(buf, option, create_database_option_formats, lengthof(create_database_option_formats)); } } /* * Converts a CreatedbStmt structure into a SQL command string. * Used in the deparsing of Create database statement. */ char * DeparseCreateDatabaseStmt(Node *node) { CreatedbStmt *stmt = castNode(CreatedbStmt, node); StringInfoData str = { 0 }; initStringInfo(&str); AppendCreateDatabaseStmt(&str, stmt); return str.data; } /* * Prepares a DROP DATABASE statement with given empty StringInfo buffer and DropdbStmt node. */ static void AppendDropDatabaseStmt(StringInfo buf, DropdbStmt *stmt) { char *ifExistsStatement = stmt->missing_ok ? "IF EXISTS" : ""; appendStringInfo(buf, "DROP DATABASE %s %s", ifExistsStatement, quote_identifier(stmt->dbname)); DefElem *option = NULL; foreach_ptr(option, stmt->options) { if (strcmp(option->defname, "force") == 0) { appendStringInfo(buf, " FORCE"); } else { ereport(ERROR, (errcode(ERRCODE_SYNTAX_ERROR), errmsg("unrecognized DROP DATABASE option \"%s\"", option->defname))); } } } /* * Converts a DropdbStmt structure into a SQL command string. * Used in the deparsing of drop database statement. */ char * DeparseDropDatabaseStmt(Node *node) { DropdbStmt *stmt = castNode(DropdbStmt, node); StringInfoData str = { 0 }; initStringInfo(&str); AppendDropDatabaseStmt(&str, stmt); return str.data; }