Copying a Configuration

Copy an existing OCI Database with PostgreSQL database system configuration so that its variables and extensions can be updated.

    1. Open the navigation menu and select Databases. Under PostgreSQL, select Configurations.
    2. (Optional) In the List scope section, under Compartment, select a compartment.
    3. In the Configurations table, click the name of the configuration that you want to copy.
    4. On the configuration's details page, select Copy configuration and extensions.
    5. In the Copy configuration and extensions panel, provide the following basic information:
      • Name: Enter a name for the configuration list. Avoid entering confidential information.
      • Description: Enter a description for the configuration list.
      • Configuration shape type: Select either Flex or Fixed. Flexible configurations can be applied to database systems with varying shapes and hardware configurations. A fixed configuration can only be applied to a database system with a specific, fixed shape and matching hardware configuration. For more information, see Supported Shapes.
    6. In the Configure placement and hardware section, provide values for the following:
      • Select a compartment: Select the compartment to contain the configuration.
      • Shape series: Select a processor group.
        • AMD: (Flexible) Standard shapes that use current-generation AMD processors.
        • Intel: (Flexible) Standard shapes that use current-generation Intel processors.
      • Shape name: If using a fixed shape, select the shape of database system that this configuration list can be applied to.
    7. In the User variables (read/write) section, add or update existing variables as needed:
      • Variable name: Select a user variable from the list.
      • Variable value: Select or enter a value for the 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.
    8. In the Configure extensions section, provide the following information:
      • PostgreSQL extensions: Select an extension from the list.
      • Variable name: Select a variable for the selected extension from the list.
      • Variable value: Select or enter a value for the variable.

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

    9. (Optional) Show advanced options: 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.
    10. Select Create.
  • Use the oci psql configuration create command and required parameters with existing information from oci psql default-configuration get to copy a default configuration:

    oci psql default-configuration get --configuration-id <configuration_OCID> [OPTIONS]
    oci psql configuration create --compartment-id <compartment_OCID> [OPTIONS]

    Use --db-configuration-overrides along with a key of oci.allowed_extensions to enable extensions for the configuration. For more information, see Supported PostgreSQL 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 with existing information to copy a configuration.

    Use dbConfigurationOverrides along with a configKey of oci.allowed_extensions to enable extensions. For more information, see Supported PostgreSQL Extensions for OCI Database with PostgreSQL.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.