summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 0de0cc1)
raw | patch | inline | side by side (parent: 0de0cc1)
| author | Tom Lane <tgl@sss.pgh.pa.us> | |
| Sat, 12 Feb 2011 21:40:41 +0000 (16:40 -0500) | ||
| committer | Tom Lane <tgl@sss.pgh.pa.us> | |
| Sat, 12 Feb 2011 21:40:41 +0000 (16:40 -0500) |
This change causes a multi-step update sequence to behave exactly as if the
updates had been commanded one at a time, including updating the "requires"
dependencies afresh at each step. The initial implementation took the
shortcut of examining only the final target version's "requires" and
changing the catalog entry but once. But on reflection that's a bad idea,
since it could lead to executing old update scripts under conditions
different than they were designed/tested for. Better to expend a few extra
cycles and avoid any surprises.
In the same spirit, if a CREATE EXTENSION FROM operation involves applying
a series of update files, it will act as though the CREATE had first been
done using the initial script's target version and then the additional
scripts were invoked with ALTER EXTENSION UPDATE.
I also removed the restriction about not changing encoding in secondary
control files. The new rule is that a script is assumed to be in whatever
encoding the control file(s) specify for its target version. Since this
reimplementation causes us to read each intermediate version's control
file, there's no longer any uncertainty about which encoding setting would
get applied.
updates had been commanded one at a time, including updating the "requires"
dependencies afresh at each step. The initial implementation took the
shortcut of examining only the final target version's "requires" and
changing the catalog entry but once. But on reflection that's a bad idea,
since it could lead to executing old update scripts under conditions
different than they were designed/tested for. Better to expend a few extra
cycles and avoid any surprises.
In the same spirit, if a CREATE EXTENSION FROM operation involves applying
a series of update files, it will act as though the CREATE had first been
done using the initial script's target version and then the additional
scripts were invoked with ALTER EXTENSION UPDATE.
I also removed the restriction about not changing encoding in secondary
control files. The new rule is that a script is assumed to be in whatever
encoding the control file(s) specify for its target version. Since this
reimplementation causes us to read each intermediate version's control
file, there's no longer any uncertainty about which encoding setting would
get applied.
| doc/src/sgml/extend.sgml | patch | blob | blame | history | |
| src/backend/commands/extension.c | patch | blob | blame | history |
index 90248e59e78fec8f5fdff985c6b5813d87974a5e..394aa87900286a1bc289fc9ff6327b89ffa33c27 100644 (file)
--- a/doc/src/sgml/extend.sgml
+++ b/doc/src/sgml/extend.sgml
Secondary control files follow the same format as the primary control
file. Any parameters set in a secondary control file override the
primary control file when installing or updating to that version of
- the extension. However, the parameters <varname>directory</>,
- <varname>default_version</>, and <varname>encoding</> cannot be set in
- a secondary control file; in particular, the same encoding must be used
- in all script files associated with the extension.
+ the extension. However, the parameters <varname>directory</> and
+ <varname>default_version</> cannot be set in a secondary control file.
</para>
<para>
@@ -689,6 +687,12 @@ SELECT pg_catalog.pg_extension_config_dump('my_config', 'WHERE NOT standard_entr
to the extension.
</para>
+ <para>
+ If an extension has secondary control files, the control parameters
+ that are used for an update script are those associated with the script's
+ target (new) version.
+ </para>
+
<para>
The update mechanism can be used to solve an important special case:
converting a <quote>loose</> collection of objects into an extension.
This makefile relies on <acronym>PGXS</acronym>, which is described
in <xref linkend="extend-pgxs">. The command <literal>make install</>
- will then install the control and script files into the correct
+ will install the control and script files into the correct
directory as reported by <application>pg_config</>.
</para>
index 702f24a35d5050715a5188ba576027799ad27905..99aface408f29a130a80b8d5884a394790d2835a 100644 (file)
struct ExtensionVersionInfo *previous; /* current best predecessor */
} ExtensionVersionInfo;
+/* Local functions */
+static void ApplyExtensionUpdates(Oid extensionOid,
+ ExtensionControlFile *pcontrol,
+ const char *initialVersion,
+ List *updateVersions);
+
/*
* get_extension_oid - given an extension name, look up the OID
}
else if (strcmp(item->name, "encoding") == 0)
{
- if (version)
- ereport(ERROR,
- (errcode(ERRCODE_SYNTAX_ERROR),
- errmsg("parameter \"%s\" cannot be set in a per-version extension control file",
- item->name)));
-
control->encoding = pg_valid_server_encoding(item->value);
if (control->encoding < 0)
ereport(ERROR,
return control;
}
+/*
+ * Read the auxiliary control file for the specified extension and version.
+ *
+ * Returns a new modified ExtensionControlFile struct; the original struct
+ * (reflecting just the primary control file) is not modified.
+ */
+static ExtensionControlFile *
+read_extension_aux_control_file(const ExtensionControlFile *pcontrol,
+ const char *version)
+{
+ ExtensionControlFile *acontrol;
+
+ /*
+ * Flat-copy the struct. Pointer fields share values with original.
+ */
+ acontrol = (ExtensionControlFile *) palloc(sizeof(ExtensionControlFile));
+ memcpy(acontrol, pcontrol, sizeof(ExtensionControlFile));
+
+ /*
+ * Parse the auxiliary control file, overwriting struct fields
+ */
+ parse_extension_control_file(acontrol, version);
+
+ return acontrol;
+}
+
/*
* Read a SQL script file into a string, and convert to database encoding
*/
* Given an initial and final version name, identify the sequence of update
* scripts that have to be applied to perform that update.
*
- * Result is a List of names of versions to transition through.
+ * Result is a List of names of versions to transition through (the initial
+ * version is *not* included).
*/
static List *
identify_update_path(ExtensionControlFile *control,
char *versionName;
char *oldVersionName;
Oid extowner = GetUserId();
+ ExtensionControlFile *pcontrol;
ExtensionControlFile *control;
+ List *updateVersions;
List *requiredExtensions;
List *requiredSchemas;
Oid extensionOid;
* any non-ASCII data, so there is no need to worry about encoding at this
* point.
*/
- control = read_extension_control_file(stmt->extname);
+ pcontrol = read_extension_control_file(stmt->extname);
/*
* Read the statement option list
*/
if (d_new_version && d_new_version->arg)
versionName = strVal(d_new_version->arg);
- else if (control->default_version)
- versionName = control->default_version;
+ else if (pcontrol->default_version)
+ versionName = pcontrol->default_version;
else
{
ereport(ERROR,
check_valid_version_name(versionName);
/*
- * Modify control parameters for specific new version
- */
- parse_extension_control_file(control, versionName);
-
- /*
- * Determine the (unpackaged) version to update from, if any
+ * Determine the (unpackaged) version to update from, if any, and then
+ * figure out what sequence of update scripts we need to apply.
*/
if (d_old_version && d_old_version->arg)
{
oldVersionName = strVal(d_old_version->arg);
check_valid_version_name(oldVersionName);
+
+ updateVersions = identify_update_path(pcontrol,
+ oldVersionName,
+ versionName);
+
+ if (list_length(updateVersions) == 1)
+ {
+ /*
+ * Simple case where there's just one update script to run.
+ * We will not need any follow-on update steps.
+ */
+ Assert(strcmp((char *) linitial(updateVersions), versionName) == 0);
+ updateVersions = NIL;
+ }
+ else
+ {
+ /*
+ * Multi-step sequence. We treat this as installing the version
+ * that is the target of the first script, followed by successive
+ * updates to the later versions.
+ */
+ versionName = (char *) linitial(updateVersions);
+ updateVersions = list_delete_first(updateVersions);
+ }
}
else
+ {
oldVersionName = NULL;
+ updateVersions = NIL;
+ }
+
+ /*
+ * Fetch control parameters for installation target version
+ */
+ control = read_extension_aux_control_file(pcontrol, versionName);
/*
* Determine the target schema to install the extension into
CreateComments(extensionOid, ExtensionRelationId, 0, control->comment);
/*
- * Finally, execute the extension's script file(s)
+ * Execute the installation script file
*/
- if (oldVersionName == NULL)
- {
- /* Simple install */
- execute_extension_script(extensionOid, control,
- oldVersionName, versionName,
- requiredSchemas,
- schemaName, schemaOid);
- }
- else
- {
- /* Update from unpackaged objects --- find update-file path */
- List *updateVersions;
+ execute_extension_script(extensionOid, control,
+ oldVersionName, versionName,
+ requiredSchemas,
+ schemaName, schemaOid);
- updateVersions = identify_update_path(control,
- oldVersionName,
- versionName);
-
- foreach(lc, updateVersions)
- {
- char *vname = (char *) lfirst(lc);
-
- execute_extension_script(extensionOid, control,
- oldVersionName, vname,
- requiredSchemas,
- schemaName, schemaOid);
- oldVersionName = vname;
- }
- }
+ /*
+ * If additional update scripts have to be executed, apply the updates
+ * as though a series of ALTER EXTENSION UPDATE commands were given
+ */
+ ApplyExtensionUpdates(extensionOid, pcontrol,
+ versionName, updateVersions);
}
/*
ExecAlterExtensionStmt(AlterExtensionStmt *stmt)
{
DefElem *d_new_version = NULL;
- char *schemaName;
- Oid schemaOid;
char *versionName;
char *oldVersionName;
ExtensionControlFile *control;
- List *requiredExtensions;
- List *requiredSchemas;
Oid extensionOid;
Relation extRel;
ScanKeyData key[1];
SysScanDesc extScan;
HeapTuple extTup;
- Form_pg_extension extForm;
- Datum values[Natts_pg_extension];
- bool nulls[Natts_pg_extension];
- bool repl[Natts_pg_extension];
List *updateVersions;
- ObjectAddress myself;
Datum datum;
bool isnull;
ListCell *lc;
/*
* We use global variables to track the extension being created, so we
- * can create/alter only one extension at the same time.
+ * can create/update only one extension at the same time.
*/
if (creating_extension)
ereport(ERROR,
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
errmsg("nested ALTER EXTENSION is not supported")));
- /* Look up the extension --- it must already exist in pg_extension */
- extRel = heap_open(ExtensionRelationId, RowExclusiveLock);
+ /*
+ * Look up the extension --- it must already exist in pg_extension
+ */
+ extRel = heap_open(ExtensionRelationId, AccessShareLock);
ScanKeyInit(&key[0],
Anum_pg_extension_extname,
errmsg("extension \"%s\" does not exist",
stmt->extname)));
- /* Copy tuple so we can modify it below */
- extTup = heap_copytuple(extTup);
- extForm = (Form_pg_extension) GETSTRUCT(extTup);
extensionOid = HeapTupleGetOid(extTup);
+ /*
+ * Determine the existing version we are updating from
+ */
+ datum = heap_getattr(extTup, Anum_pg_extension_extversion,
+ RelationGetDescr(extRel), &isnull);
+ if (isnull)
+ elog(ERROR, "extversion is null");
+ oldVersionName = text_to_cstring(DatumGetTextPP(datum));
+
systable_endscan(extScan);
+ heap_close(extRel, AccessShareLock);
+
/*
* Read the primary control file. Note we assume that it does not contain
* any non-ASCII data, so there is no need to worry about encoding at this
}
/*
- * Determine the version to install
+ * Determine the version to update to
*/
if (d_new_version && d_new_version->arg)
versionName = strVal(d_new_version->arg);
check_valid_version_name(versionName);
/*
- * Modify control parameters for specific new version
+ * Identify the series of update script files we need to execute
*/
- parse_extension_control_file(control, versionName);
+ updateVersions = identify_update_path(control,
+ oldVersionName,
+ versionName);
/*
- * Determine the existing version we are upgrading from
+ * Update the pg_extension row and execute the update scripts, one at a
+ * time
*/
- datum = heap_getattr(extTup, Anum_pg_extension_extversion,
- RelationGetDescr(extRel), &isnull);
- if (isnull)
- elog(ERROR, "extversion is null");
- oldVersionName = text_to_cstring(DatumGetTextPP(datum));
+ ApplyExtensionUpdates(extensionOid, control,
+ oldVersionName, updateVersions);
+}
- /*
- * Determine the target schema (already set by original install)
- */
- schemaOid = extForm->extnamespace;
- schemaName = get_namespace_name(schemaOid);
+/*
+ * Apply a series of update scripts as though individual ALTER EXTENSION
+ * UPDATE commands had been given, including altering the pg_extension row
+ * and dependencies each time.
+ *
+ * This might be more work than necessary, but it ensures that old update
+ * scripts don't break if newer versions have different control parameters.
+ */
+static void
+ApplyExtensionUpdates(Oid extensionOid,
+ ExtensionControlFile *pcontrol,
+ const char *initialVersion,
+ List *updateVersions)
+{
+ const char *oldVersionName = initialVersion;
+ ListCell *lcv;
- /*
- * Look up the prerequisite extensions, and build lists of their OIDs
- * and the OIDs of their target schemas. We assume that the requires
- * list is version-specific, so the dependencies can change across
- * versions. But note that only the final version's requires list
- * is being consulted here!
- */
- requiredExtensions = NIL;
- requiredSchemas = NIL;
- foreach(lc, control->requires)
+ foreach(lcv, updateVersions)
{
- char *curreq = (char *) lfirst(lc);
- Oid reqext;
- Oid reqschema;
+ char *versionName = (char *) lfirst(lcv);
+ ExtensionControlFile *control;
+ char *schemaName;
+ Oid schemaOid;
+ List *requiredExtensions;
+ List *requiredSchemas;
+ Relation extRel;
+ ScanKeyData key[1];
+ SysScanDesc extScan;
+ HeapTuple extTup;
+ Form_pg_extension extForm;
+ Datum values[Natts_pg_extension];
+ bool nulls[Natts_pg_extension];
+ bool repl[Natts_pg_extension];
+ ObjectAddress myself;
+ ListCell *lc;
/*
- * We intentionally don't use get_extension_oid's default error
- * message here, because it would be confusing in this context.
+ * Fetch parameters for specific version (pcontrol is not changed)
*/
- reqext = get_extension_oid(curreq, true);
- if (!OidIsValid(reqext))
- ereport(ERROR,
- (errcode(ERRCODE_UNDEFINED_OBJECT),
- errmsg("required extension \"%s\" is not installed",
- curreq)));
- reqschema = get_extension_schema(reqext);
- requiredExtensions = lappend_oid(requiredExtensions, reqext);
- requiredSchemas = lappend_oid(requiredSchemas, reqschema);
- }
+ control = read_extension_aux_control_file(pcontrol, versionName);
- /*
- * Modify extversion in the pg_extension tuple
- */
- memset(values, 0, sizeof(values));
- memset(nulls, 0, sizeof(nulls));
- memset(repl, 0, sizeof(repl));
+ /* Find the pg_extension tuple */
+ extRel = heap_open(ExtensionRelationId, RowExclusiveLock);
- values[Anum_pg_extension_extversion - 1] = CStringGetTextDatum(versionName);
- repl[Anum_pg_extension_extversion - 1] = true;
+ ScanKeyInit(&key[0],
+ ObjectIdAttributeNumber,
+ BTEqualStrategyNumber, F_OIDEQ,
+ ObjectIdGetDatum(extensionOid));
- extTup = heap_modify_tuple(extTup, RelationGetDescr(extRel),
- values, nulls, repl);
+ extScan = systable_beginscan(extRel, ExtensionOidIndexId, true,
+ SnapshotNow, 1, key);
- simple_heap_update(extRel, &extTup->t_self, extTup);
- CatalogUpdateIndexes(extRel, extTup);
+ extTup = systable_getnext(extScan);
- heap_close(extRel, RowExclusiveLock);
+ if (!HeapTupleIsValid(extTup)) /* should not happen */
+ elog(ERROR, "extension with oid %u does not exist",
+ extensionOid);
- /*
- * Remove and recreate dependencies on prerequisite extensions
- */
- deleteDependencyRecordsForClass(ExtensionRelationId, extensionOid,
- ExtensionRelationId, DEPENDENCY_NORMAL);
+ extForm = (Form_pg_extension) GETSTRUCT(extTup);
- myself.classId = ExtensionRelationId;
- myself.objectId = extensionOid;
- myself.objectSubId = 0;
+ /*
+ * Determine the target schema (set by original install)
+ */
+ schemaOid = extForm->extnamespace;
+ schemaName = get_namespace_name(schemaOid);
- foreach(lc, requiredExtensions)
- {
- Oid reqext = lfirst_oid(lc);
- ObjectAddress otherext;
+ /*
+ * Modify extrelocatable and extversion in the pg_extension tuple
+ */
+ memset(values, 0, sizeof(values));
+ memset(nulls, 0, sizeof(nulls));
+ memset(repl, 0, sizeof(repl));
- otherext.classId = ExtensionRelationId;
- otherext.objectId = reqext;
- otherext.objectSubId = 0;
+ values[Anum_pg_extension_extrelocatable - 1] =
+ BoolGetDatum(control->relocatable);
+ repl[Anum_pg_extension_extrelocatable - 1] = true;
+ values[Anum_pg_extension_extversion - 1] =
+ CStringGetTextDatum(versionName);
+ repl[Anum_pg_extension_extversion - 1] = true;
- recordDependencyOn(&myself, &otherext, DEPENDENCY_NORMAL);
- }
+ extTup = heap_modify_tuple(extTup, RelationGetDescr(extRel),
+ values, nulls, repl);
- /*
- * Finally, execute the extension's script file(s)
- */
- updateVersions = identify_update_path(control,
- oldVersionName,
- versionName);
+ simple_heap_update(extRel, &extTup->t_self, extTup);
+ CatalogUpdateIndexes(extRel, extTup);
- foreach(lc, updateVersions)
- {
- char *vname = (char *) lfirst(lc);
+ systable_endscan(extScan);
+
+ heap_close(extRel, RowExclusiveLock);
+ /*
+ * Look up the prerequisite extensions for this version, and build
+ * lists of their OIDs and the OIDs of their target schemas.
+ */
+ requiredExtensions = NIL;
+ requiredSchemas = NIL;
+ foreach(lc, control->requires)
+ {
+ char *curreq = (char *) lfirst(lc);
+ Oid reqext;
+ Oid reqschema;
+
+ /*
+ * We intentionally don't use get_extension_oid's default error
+ * message here, because it would be confusing in this context.
+ */
+ reqext = get_extension_oid(curreq, true);
+ if (!OidIsValid(reqext))
+ ereport(ERROR,
+ (errcode(ERRCODE_UNDEFINED_OBJECT),
+ errmsg("required extension \"%s\" is not installed",
+ curreq)));
+ reqschema = get_extension_schema(reqext);
+ requiredExtensions = lappend_oid(requiredExtensions, reqext);
+ requiredSchemas = lappend_oid(requiredSchemas, reqschema);
+ }
+
+ /*
+ * Remove and recreate dependencies on prerequisite extensions
+ */
+ deleteDependencyRecordsForClass(ExtensionRelationId, extensionOid,
+ ExtensionRelationId,
+ DEPENDENCY_NORMAL);
+
+ myself.classId = ExtensionRelationId;
+ myself.objectId = extensionOid;
+ myself.objectSubId = 0;
+
+ foreach(lc, requiredExtensions)
+ {
+ Oid reqext = lfirst_oid(lc);
+ ObjectAddress otherext;
+
+ otherext.classId = ExtensionRelationId;
+ otherext.objectId = reqext;
+ otherext.objectSubId = 0;
+
+ recordDependencyOn(&myself, &otherext, DEPENDENCY_NORMAL);
+ }
+
+ /*
+ * Finally, execute the update script file
+ */
execute_extension_script(extensionOid, control,
- oldVersionName, vname,
+ oldVersionName, versionName,
requiredSchemas,
schemaName, schemaOid);
- oldVersionName = vname;
+
+ /*
+ * Update prior-version name and loop around. Since execute_sql_string
+ * did a final CommandCounterIncrement, we can update the pg_extension
+ * row again.
+ */
+ oldVersionName = versionName;
}
}