EDB Postgres™ Advanced Server Guide EDB Postgres™ Advanced Server 10 February 15, 2021 EDB Postgres™ Advanced Server Guide by EnterpriseDB® Corporation Copyright © 2014 - 2021 EnterpriseDB Corporation EnterpriseDB Corporation, 34 Crosby Drive, Suite 201, Bedford, MA 01730, USA T +1 781 357 3390 F +1 978 467 1307 E [email protected] www.enterprisedb.com Copyright © 2014 - 2021 EnterpriseDB Corporation. All rights reserved. 2 EDB Postgres Advanced Server Guide Table of Contents 1 Introduction ................................................................................................................. 8 1.1 What’s New ...................................................................................................... 11 1.2 Typographical Conventions Used in this Guide ............................................... 12 1.3 Other Conventions Used in this Guide ............................................................. 13 1.4 About the Examples Used in this Guide ........................................................... 14 1.4.1 Sample Database Description ....................................................................... 14 2 Enhanced Compatibility Features ............................................................................. 23 2.1 Enabling Compatibility Features ...................................................................... 24 2.2 Stored Procedural Language ............................................................................. 24 2.3 Optimizer Hints ................................................................................................. 25 2.4 Data Dictionary Views ...................................................................................... 25 2.5 dblink_ora ......................................................................................................... 26 2.6 Profile Management .......................................................................................... 26 2.7 Built-In Packages .............................................................................................. 27 2.8 Open Client Library .......................................................................................... 29 2.9 Utilities .............................................................................................................. 30 2.10 ECPGPlus ......................................................................................................... 32 2.11 Table Partitioning.............................................................................................. 33 3 Database Administration ........................................................................................... 34 3.1 Configuration Parameters ................................................................................. 34 3.1.1 Setting Configuration Parameters ................................................................. 35 3.1.2 Summary of Configuration Parameters ........................................................ 37 3.1.3 Configuration Parameters by Functionality .................................................. 55 3.1.3.1 Top Performance Related Parameters ................................................... 56 3.1.3.2 Resource Usage / Memory .................................................................... 67 3.1.3.3 Resource Usage / EDB Resource Manager .......................................... 72 3.1.3.4 Query Tuning ........................................................................................ 74 3.1.3.5 Query Tuning / Planner Method Configuration .................................... 74 3.1.3.6 Reporting and Logging / What to Log .................................................. 77 3.1.3.7 Auditing Settings .................................................................................. 79 3.1.3.8 Client Connection Defaults / Locale and Formatting ........................... 84 3.1.3.9 Client Connection Defaults / Statement Behavior ................................ 84 3.1.3.10 Client Connection Defaults / Other Defaults .................................... 85 3.1.3.11 Compatibility Options ....................................................................... 87 3.1.3.12 Customized Options .......................................................................... 95 3.1.3.13 Ungrouped....................................................................................... 104 3.2 Index Advisor.................................................................................................. 107 3.2.1 Index Advisor Components ........................................................................ 108 3.2.2 Index Advisor Configuration ...................................................................... 109 3.2.3 Using Index Advisor ................................................................................... 112 3.2.3.1 Using the pg_advise_index Utility...................................................... 112 3.2.3.2 Using Index Advisor at the psql Command Line................................ 114 3.2.4 Reviewing the Index Advisor Recommendations ....................................... 116 Copyright © 2014 - 2021 EnterpriseDB Corporation. All rights reserved. 3 EDB Postgres Advanced Server Guide 3.2.4.1 Using the show_index_recommendations() Function ........................ 116 3.2.4.2 Querying the index_advisor_log Table ............................................... 117 3.2.4.3 Querying the index_recommendations View ...................................... 119 3.2.5 Limitations .................................................................................................. 120 3.3 SQL Profiler .................................................................................................... 122 3.4 pgsnmpd .......................................................................................................... 124 3.4.1 Configuring pgsnmpd ................................................................................. 124 3.4.2 Setting the Listener Address ....................................................................... 125 3.4.3 Invoking pgsnmpd ...................................................................................... 125 3.4.4 Viewing pgsnmpd Help .............................................................................. 126 3.4.5 Requesting Information from pgsnmpd ...................................................... 126 3.5 EDB Audit Logging ........................................................................................ 127 3.5.1 Audit Logging Configuration Parameters ................................................... 127 3.5.2 Selecting SQL Statements to Audit ............................................................ 129 3.5.2.1 Data Definition Language and Data Control Language Statements ... 130 3.5.2.2 Data Manipulation Language Statements ........................................... 135 3.5.3 Enabling Audit Logging ............................................................................. 138 3.5.4 Audit Log File ............................................................................................. 142 3.5.5 Filtering Audit Logs Using Error Codes ..................................................... 147 3.5.6 Filtering Audit Logs Using Command Tags ............................................... 147 3.6 Unicode Collation Algorithm ......................................................................... 149 3.6.1 Basic Unicode Collation Algorithm Concepts ............................................ 150 3.6.2 International Components for Unicode ....................................................... 151 3.6.2.1 Locale Collations ................................................................................ 151 3.6.2.2 Collation Attributes ............................................................................. 152 3.6.3 Creating an ICU Collation .......................................................................... 155 3.6.3.1 CREATE COLLATION ..................................................................... 155 3.6.3.2 CREATE DATABASE ....................................................................... 157 3.6.3.3 initdb ................................................................................................... 158 3.6.4 Using a Collation ........................................................................................ 160 3.7 Customizable WAL Segment File Size .......................................................... 164 3.8 Slony ............................................................................................................... 166 4 Security ................................................................................................................... 168 4.1 Protecting Against SQL Injection Attacks ...................................................... 168 4.1.1 SQL/Protect Overview ................................................................................ 169 4.1.1.1 Types of SQL Injection Attacks ......................................................... 169 4.1.1.2 Monitoring SQL Injection Attacks ..................................................... 170 4.1.2 Configuring SQL/Protect ............................................................................ 173 4.1.2.1 Selecting Roles to Protect ................................................................... 175 4.1.2.2 Monitoring Protected Roles ................................................................ 177 4.1.3 Common Maintenance Operations