Categories:

System Functions (System Control)

SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER

Enables Database Replication for a specified account in an organization. Once an organization administrator (user with the ORGADMIN role) has called this function to enable Database Replication, an account administrator (user with the ACCOUNTADMIN role) can promote local databases as primary databases and create replicas (i.e. secondary databases) of these primary databases in accounts in other regions.

Call the SQL function once for each account in your organization for which you are enabling Database Replication. This includes each account that you intend to contain a primary or secondary database.

Syntax

SELECT SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER('<account_identifier>',
  'ENABLE_ACCOUNT_DATABASE_REPLICATION', 'true');

Arguments

<account_identifier>

Identifier of an account for which you are enabling Database Replication. The preferred format for the identifier is organization_name.account_name. Though the legacy account_locator format is also supported, its use is discouraged as it can cause unexpected results when an organization has multiple accounts with the same locator (in different regions).

Retrieve the set of accounts in your organization using the SHOW ORGANIZATION ACCOUNTS command, which returns details about each account, including the organization name, account name, and account locator.

Usage Notes

  • Only organization administrators (i.e. users with the ORGADMIN role) can call this SQL function.

  • When Database Replication is enabled for an account using this SQL function, the SHOW REPLICATION ACCOUNTS output includes the account.

  • If you have more than one account with the same account locator in different regions, to enable replication, you must use organization_name.account_name as the account identifier.

Examples

The following example enables Database Replication for the account1 and account2 accounts in the myorg organization:

SELECT SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER('myorg.account1',
  'ENABLE_ACCOUNT_DATABASE_REPLICATION', 'true');

SELECT SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER('myorg.account2',
  'ENABLE_ACCOUNT_DATABASE_REPLICATION', 'true');
Back to top