Oracle Cloud Infrastructure Documentation

Creating an OCI Database with PostgreSQL Configuration

Create an OCI Database with PostgreSQL database system configuration to manage variables and extensions.

Important

OCI Database with PostgreSQL provides optimized default configurations out of the box targeting a specific shape. Only advanced users might need to change and manage them. For more information, see PostgreSQL reference manual.

When creating a configuration, select either a fixed configuration or a flexible configuration.

A fixed configuration is associated with specific hardware details, and can only be applied to database systems with hardware configurations where OCPU and memory exactly match those details.

A flexible configuration can be applied to database systems with differing hardware configurations. If a database system uses a flexible configuration, you can update its hardware configuration without the need to change configurations. Flexible configurations let you use integer expressions for some variable values. For more information, see Flexible Configurations and Integer Variables.

  • On the Configurations list page, select Create configuration. If you need help finding the list page, see Listing OCI Database with PostgreSQL Configurations.
    The Create configuration panel opens.

    Basic information

    Enter the following information:

    • Name: Enter a name for the configuration list. Avoid entering confidential information.
    • Description: (Optional) Enter a description for the configuration list.
    • PostgreSQL version: Select a major version of the PostgreSQL database from the list.
    • Configuration shape type: Select one of the following configuration shape options:
      • Flex: Allows you to configure the amount of OCPU and memory.
      • Fixed: Come with a set values for OCPU and memory.

    Tags

    Under Tags, select Add tag to apply tagging to your database system.

    If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.

    Placement and hardware

    Enter the following information:

    • Compartment: Select the compartment to contain the configuration.
    • Configuration shape type: Select one of the following configuration shape type options:
      • Flex: You can apply flexible configurations to database systems with varying shapes and hardware configurations. Select the Compatible shape series of the database systems that this configuration can be applied to. By default, the widest group of compatible shapes is selected. For more information, see OCI Database with PostgreSQL Supported Shapes.
      • Fixed: A fixed configuration can only be applied to a database system with specific, fixed shapes and matching hardware configuration. Select a processor group as the Shape series and then select the Shape name.

        Details of the shape you selected are displayed.

    User variables (read/write)

    Enter the following information:

    • Variable name: Select a user variable from the list.
    • Variable value: Select or enter a value for the variable.

    Select Add variable to create another variable.

    Tip

    If the configuration supports flexible shapes, you can use integer expressions for some values. For more information, see Flexible Configurations and Integer Variables.

  • Use the oci psql configuration create command and required parameters to create a configuration:

    oci psql configuration create --compartment-id <compartment_ocid> [OPTIONS]

    A list of admin-enabled extensions can be specified using the oci.admin_enabled_extensions configuration parameter as part of db-configuration-overrides. For example:

    oci psql configuration create --compartment-id <compartment_ocid> --db-version <db_version> --display-name <display_name> --db-configuration-overrides <file://db-configuration-overrides.json> [OPTIONS]

    For more information, see Supported Extensions for OCI Database with PostgreSQL.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the CreateConfiguration operation to create a configuration.

    Use dbConfigurationOverrides along with a configKey of oci.admin_enabled_extensions='<extension1,extension2>' and the required value to enable extensions for the configuration. For more information, see Supported Extensions for OCI Database with PostgreSQL.