]> begriffs open source - ai-pg/blob - full-docs/src/sgml/html/catalog-pg-default-acl.html
WIP: toc builder
[ai-pg] / full-docs / src / sgml / html / catalog-pg-default-acl.html
1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>52.17. pg_default_acl</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="prev" href="catalog-pg-db-role-setting.html" title="52.16. pg_db_role_setting" /><link rel="next" href="catalog-pg-depend.html" title="52.18. pg_depend" /></head><body id="docContent" class="container-fluid col-10"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">52.17. <code class="structname">pg_default_acl</code></th></tr><tr><td width="10%" align="left"><a accesskey="p" href="catalog-pg-db-role-setting.html" title="52.16. pg_db_role_setting">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="catalogs.html" title="Chapter 52. System Catalogs">Up</a></td><th width="60%" align="center">Chapter 52. System Catalogs</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 18.0 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="catalog-pg-depend.html" title="52.18. pg_depend">Next</a></td></tr></table><hr /></div><div class="sect1" id="CATALOG-PG-DEFAULT-ACL"><div class="titlepage"><div><div><h2 class="title" style="clear: both">52.17. <code class="structname">pg_default_acl</code> <a href="#CATALOG-PG-DEFAULT-ACL" class="id_link">#</a></h2></div></div></div><a id="id-1.10.4.19.2" class="indexterm"></a><p>
3    The catalog <code class="structname">pg_default_acl</code> stores initial
4    privileges to be assigned to newly created objects.
5   </p><div class="table" id="id-1.10.4.19.4"><p class="title"><strong>Table 52.17. <code class="structname">pg_default_acl</code> Columns</strong></p><div class="table-contents"><table class="table" summary="pg_default_acl Columns" border="1"><colgroup><col /></colgroup><thead><tr><th class="catalog_table_entry"><p class="column_definition">
6        Column Type
7       </p>
8       <p>
9        Description
10       </p></th></tr></thead><tbody><tr><td class="catalog_table_entry"><p class="column_definition">
11        <code class="structfield">oid</code> <code class="type">oid</code>
12       </p>
13       <p>
14        Row identifier
15       </p></td></tr><tr><td class="catalog_table_entry"><p class="column_definition">
16        <code class="structfield">defaclrole</code> <code class="type">oid</code>
17        (references <a class="link" href="catalog-pg-authid.html" title="52.8. pg_authid"><code class="structname">pg_authid</code></a>.<code class="structfield">oid</code>)
18       </p>
19       <p>
20        The OID of the role associated with this entry
21       </p></td></tr><tr><td class="catalog_table_entry"><p class="column_definition">
22        <code class="structfield">defaclnamespace</code> <code class="type">oid</code>
23        (references <a class="link" href="catalog-pg-namespace.html" title="52.32. pg_namespace"><code class="structname">pg_namespace</code></a>.<code class="structfield">oid</code>)
24       </p>
25       <p>
26        The OID of the namespace associated with this entry,
27        or zero if none
28       </p></td></tr><tr><td class="catalog_table_entry"><p class="column_definition">
29        <code class="structfield">defaclobjtype</code> <code class="type">char</code>
30       </p>
31       <p>
32        Type of object this entry is for:
33        <code class="literal">r</code> = relation (table, view),
34        <code class="literal">S</code> = sequence,
35        <code class="literal">f</code> = function,
36        <code class="literal">T</code> = type,
37        <code class="literal">n</code> = schema,
38        <code class="literal">L</code> = large object
39       </p></td></tr><tr><td class="catalog_table_entry"><p class="column_definition">
40        <code class="structfield">defaclacl</code> <code class="type">aclitem[]</code>
41       </p>
42       <p>
43        Access privileges that this type of object should have on creation
44       </p></td></tr></tbody></table></div></div><br class="table-break" /><p>
45    A <code class="structname">pg_default_acl</code> entry shows the initial privileges to
46    be assigned to an object belonging to the indicated user.  There are
47    currently two types of entry: <span class="quote">“<span class="quote">global</span>”</span> entries with
48    <code class="structfield">defaclnamespace</code> = zero, and <span class="quote">“<span class="quote">per-schema</span>”</span> entries
49    that reference a particular schema.  If a global entry is present then
50    it <span class="emphasis"><em>overrides</em></span> the normal hard-wired default privileges
51    for the object type.  A per-schema entry, if present, represents privileges
52    to be <span class="emphasis"><em>added to</em></span> the global or hard-wired default privileges.
53   </p><p>
54    Note that when an <acronym class="acronym">ACL</acronym> entry in another catalog is null,
55    it is taken to represent the hard-wired default privileges for its object,
56    <span class="emphasis"><em>not</em></span> whatever might be in <code class="structname">pg_default_acl</code>
57    at the moment.  <code class="structname">pg_default_acl</code> is only consulted during
58    object creation.
59   </p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="catalog-pg-db-role-setting.html" title="52.16. pg_db_role_setting">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="catalogs.html" title="Chapter 52. System Catalogs">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="catalog-pg-depend.html" title="52.18. pg_depend">Next</a></td></tr><tr><td width="40%" align="left" valign="top">52.16. <code class="structname">pg_db_role_setting</code> </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 18.0 Documentation">Home</a></td><td width="40%" align="right" valign="top"> 52.18. <code class="structname">pg_depend</code></td></tr></table></div></body></html>