postgresql/contrib/pg_buffercache/pg_buffercache--1.0.sql

/* contrib/pg_buffercache/pg_buffercache--1.0.sql */

-- complain if script is sourced in psql, rather than via CREATE EXTENSION
\echo Use "CREATE EXTENSION pg_buffercache" to load this file. \quit

-- Register the function.
CREATE FUNCTION pg_buffercache_pages()
RETURNS SETOF RECORD
AS 'MODULE_PATHNAME', 'pg_buffercache_pages'
LANGUAGE C;

-- Create a view for convenient access.
CREATE VIEW pg_buffercache AS
	SELECT P.* FROM pg_buffercache_pages() AS P
	(bufferid integer, relfilenode oid, reltablespace oid, reldatabase oid,
	 relforknumber int2, relblocknumber int8, isdirty bool, usagecount int2);

-- Don't want these to be available to public.
REVOKE ALL ON FUNCTION pg_buffercache_pages() FROM PUBLIC;
REVOKE ALL ON pg_buffercache FROM PUBLIC;
Convert contrib modules to use the extension facility. This isn't fully tested as yet, in particular I'm not sure that the "foo--unpackaged--1.0.sql" scripts are OK. But it's time to get some buildfarm cycles on it. sepgsql is not converted to an extension, mainly because it seems to require a very nonstandard installation process. Dimitri Fontaine and Tom Lane 2011-02-14 09:06:41 +08:00			`/* contrib/pg_buffercache/pg_buffercache--1.0.sql */`
Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 23:36:24 +08:00
Throw a useful error message if an extension script file is fed to psql. We have seen one too many reports of people trying to use 9.1 extension files in the old-fashioned way of sourcing them in psql. Not only does that usually not work (due to failure to substitute for MODULE_PATHNAME and/or @extschema@), but if it did work they'd get a collection of loose objects not an extension. To prevent this, insert an \echo ... \quit line that prints a suitable error message into each extension script file, and teach commands/extension.c to ignore lines starting with \echo. That should not only prevent any adverse consequences of loading a script file the wrong way, but make it crystal clear to users that they need to do it differently now. Tom Lane, following an idea of Andrew Dunstan's. Back-patch into 9.1 ... there is not going to be much value in this if we wait till 9.2. 2011-10-13 03:45:03 +08:00			`-- complain if script is sourced in psql, rather than via CREATE EXTENSION`
			`\echo Use "CREATE EXTENSION pg_buffercache" to load this file. \quit`

Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 23:36:24 +08:00			`-- Register the function.`
Avoid use of CREATE OR REPLACE FUNCTION in extension installation files. It was never terribly consistent to use OR REPLACE (because of the lack of comparable functionality for data types, operators, etc), and experimentation shows that it's now positively pernicious in the extension world. We really want a failure to occur if there are any conflicts, else it's unclear what the extension-ownership state of the conflicted object ought to be. Most of the time, CREATE EXTENSION will fail anyway because of conflicts on other object types, but an extension defining only functions can succeed, with bad results. 2011-02-14 10:24:14 +08:00			`CREATE FUNCTION pg_buffercache_pages()`
Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 23:36:24 +08:00			`RETURNS SETOF RECORD`
			`AS 'MODULE_PATHNAME', 'pg_buffercache_pages'`
Clean up CREATE FUNCTION syntax usage in contrib and elsewhere, in particular get rid of single quotes around language names and old WITH () construct. 2006-02-28 00:09:50 +08:00			`LANGUAGE C;`
Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 23:36:24 +08:00
			`-- Create a view for convenient access.`
			`CREATE VIEW pg_buffercache AS`
			`SELECT P.* FROM pg_buffercache_pages() AS P`
Remove useless whitespace at end of lines 2010-11-24 04:27:50 +08:00			`(bufferid integer, relfilenode oid, reltablespace oid, reldatabase oid,`
pg_buffercache needs to be taught about relation forks, as Greg Stark pointed out. 2008-08-14 20:56:41 +08:00			`relforknumber int2, relblocknumber int8, isdirty bool, usagecount int2);`
Remove useless whitespace at end of lines 2010-11-24 04:27:50 +08:00
Convert contrib modules to use the extension facility. This isn't fully tested as yet, in particular I'm not sure that the "foo--unpackaged--1.0.sql" scripts are OK. But it's time to get some buildfarm cycles on it. sepgsql is not converted to an extension, mainly because it seems to require a very nonstandard installation process. Dimitri Fontaine and Tom Lane 2011-02-14 09:06:41 +08:00			`-- Don't want these to be available to public.`
Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 23:36:24 +08:00			`REVOKE ALL ON FUNCTION pg_buffercache_pages() FROM PUBLIC;`
			`REVOKE ALL ON pg_buffercache FROM PUBLIC;`