CREATE DATABASE¶

在系统中创建新数据库。

该命令支持以下变体：

CREATE OR ALTER DATABASE：创建数据库（如果不存在）或更改现有数据库。
CREATE DATABASE ... CLONE：创建现有数据库的克隆，无论是在其当前状态还是在过去的特定时间/点（使用 Time Travel）。有关克隆数据库的更多信息，请参阅克隆注意事项。

此外，该命令还可用于：

从指定的列表中创建数据库。请参阅关于使用列表共享。
使用其他 Snowflake 账户提供的共享创建数据库。有关共享的更多信息，请参阅关于 Secure Data Sharing。
创建现有主数据库的副本（例如辅助数据库）。有关 Database Replication 的详细信息，请参阅跨多个账户的数据库复制简介。

小技巧

除了 SQL，您还可以使用其他接口，如 Snowflake REST APIs、Snowflake Python APIs 和 Snowflake CLI。请参阅备用接口。

另请参阅：

ALTER DATABASE、DESCRIBE DATABASE、DROP DATABASE、SHOW DATABASES、UNDROP DATABASE

DESCRIBE SHARE , SHOW SHARES, CREATE LISTING, CREATE OR ALTER <对象>

语法¶

标准数据库

CREATE [ OR REPLACE ] [ TRANSIENT ] DATABASE [ IF NOT EXISTS ] <name>
    [ CLONE <source_schema>
        [ { AT | BEFORE } ( { TIMESTAMP => <timestamp> | OFFSET => <time_difference> | STATEMENT => <id> } ) ]
        [ IGNORE TABLES WITH INSUFFICIENT DATA RETENTION ]
        [ IGNORE HYBRID TABLES ] ]
    [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
    [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
    [ EXTERNAL_VOLUME = <external_volume_name> ]
    [ CATALOG = <catalog_integration_name> ]
    [ REPLACE_INVALID_CHARACTERS = { TRUE | FALSE } ]
    [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
    [ STORAGE_SERIALIZATION_POLICY = { COMPATIBLE | OPTIMIZED } ]
    [ COMMENT = '<string_literal>' ]
    [ CATALOG_SYNC = '<snowflake_open_catalog_integration_name>' ]
    [ CATALOG_SYNC_NAMESPACE_MODE = { NEST | FLATTEN } ]
    [ CATALOG_SYNC_NAMESPACE_FLATTEN_DELIMITER = '<string_literal>' ]
    [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
    [ WITH CONTACT ( <purpose> = <contact_name> [ , <purpose> = <contact_name> ... ] ) ]
    [ OBJECT_VISIBILITY = { <object_visibility_spec> | PRIVILEGED } ]
    [ ENABLE_DATA_COMPACTION = { TRUE | FALSE } ]

Copy

Restored database (from a snapshot)

CREATE DATABASE <name> FROM SNAPSHOT SET <snapshot_set> IDENTIFIER '<snapshot_id>'

Copy

标准数据库（来自列表）

CREATE DATABASE <name> FROM LISTING '<listing_global_name>'

Copy

共享数据库（来自共享）

CREATE DATABASE <name> FROM SHARE <provider_account>.<share_name>

Copy

辅助数据库 (Database Replication)

CREATE DATABASE <name>
    AS REPLICA OF <account_identifier>.<primary_db_name>
    [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]

Copy

变体语法¶

CREATE OR ALTER DATABASE¶

如果数据库尚不存在，则创建一个新数据库，或者将现有数据库转换为在语句中定义的数据库。CREATE OR ALTER DATABASE 语句遵循 CREATE DATABASE 语句的语法规则，并具有与 ALTER DATABASE 语句相同的限制。

支持以下修改：

更改以下数据库属性和参数：

有关更多信息，请参阅 CREATE OR ALTER DATABASE 使用说明。

CREATE OR ALTER [ TRANSIENT ] DATABASE <name>
    [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
    [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
    [ EXTERNAL_VOLUME = <external_volume_name> ]
    [ CATALOG = <catalog_integration_name> ]
    [ REPLACE_INVALID_CHARACTERS = { TRUE | FALSE } ]
    [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
    [ LOG_LEVEL = '<log_level>' ]
    [ TRACE_LEVEL = '<trace_level>' ]
    [ STORAGE_SERIALIZATION_POLICY = { COMPATIBLE | OPTIMIZED } ]
    [ COMMENT = '<string_literal>' ]
    [ OBJECT_VISIBILITY = { <object_visibility_spec> | PRIVILEGED } ]

Copy

CREATE DATABASE ... CLONE¶

使用相同的参数值创建新数据库：

CREATE [ OR REPLACE ] DATABASE [ IF NOT EXISTS ] <name> CLONE <source_database>
  [ ... ]

Copy

有关更多详细信息，请参阅 CREATE <object> ... CLONE。

必填参数¶

name

指定数据库的标识符；对于您的账户必须是唯一的。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多详细信息，请参阅标识符要求。

重要

作为 :doc:` Database Replication 和故障转移 </user-guide/db-replication-intro>` 的最佳实践，我们建议为每个辅助数据库提供与其主数据库相同的名称。此实践支持同一数据库中的其他对象引用完全限定对象（即 '<db>.<schema>.<object>'），例如在视图中查询完全限定表名。

如果辅助数据库的名称与主数据库的名称不同，则这些对象引用将在辅助数据库中中断。

Database Replication 实参¶

重要

本节介绍了一种有限的 Database Replication 功能，该功能不同于账户复制功能。Snowflake 强烈建议使用账户复制功能对数据库进行复制和故障转移。

AS REPLICA OF account_identifier.primary_db_name

指定要从中创建副本（即辅助数据库）的主数据库的标识符。如果标识符包含空格、特殊字符或大小写混合字符，则整个字符串必须放在双引号内。

需要主数据库的账户标识符和名称。

account_identifier

存储主数据库的账户的唯一标识符。首选标识符为 organization_name.account_name。若要查看组织中已启用复制的账户列表，请查询 SHOW REPLICATION ACCOUNTS。

虽然旧版账户定位器也可以用作账户标识符，但不建议使用，因为旧版账户定位器未来可能无法运行。有关使用账户定位器作为账户标识符的更多详细信息，请参阅 Database Replication 使用说明。

primary_db_name

主数据库的名称。作为最佳实践，我们建议为每个辅助数据库提供与其主数据库相同的名称。

备注

作为 Database Replication 和故障转移的最佳实践，我们建议将辅助数据库上的可选参数 DATA_RETENTION_TIME_IN_DAYS 设置为与主数据库上相同的值。

Snapshot parameters¶

The FROM SNAPSHOT SET clause restores a database from a backup. You don't specify other database properties because they're all the same as in the backed-up database.

This form doesn't have a CREATE OR REPLACE clause. You typically either restore the database under a new name and recover any data or other objects from this new database, or rename the original database and then restore the database under the original name.

备注

The restored database is independent of the original database from the snapshot. There isn't any cloning relationship between the restored and original databases. Therefore, all the micro-partitions for tables in the restored database are owned by that database.

If you want to make backups of the newly restored database, create a new snapshot set for it.

For more information about snapshots, see Snapshots for backups and immutable storage.

snapshot_set: Specifies the name of a snapshot set created for a specific database. You can use the SHOW SNAPSHOT SETS command to locate the right snapshot set.
snapshot_id: Specifies the identifier of a specific snapshot within that snapshot set. You can use the SHOW SNAPSHOTS IN SNAPSHOT SET command to locate the right identifier within the snapshot set, based on the creation date and time for the snapshot.

列表参数¶

'listing_global_name'

指定用于创建数据库的列表的全局名称，该名称必须满足以下要求：

不能是付费列表。
如果列表条款不是 OFFLINE 类型，则必须已使用 Snowsight 接受。
列表数据产品必须可在当前地区本地获取。

通过查看 DESCRIBE AVAILABLE LISTING 的 is_ready_for_import 列，可以确定列表在本地区域是否可以获取。

您必须拥有 IMPORT LISTING 权限才能从列表中创建数据库。您必须拥有 IMPORT SHARE 权限才能从共享中创建数据库。

可选参数¶

TRANSIENT

将数据库指定为瞬态的。瞬态数据库没有故障安全期，因此一旦它们离开 Time Travel，它们就不会产生额外的存储成本；但是，这意味着它们在数据丢失时也不会受故障安全的保护。有关更多信息，请参阅了解和查看故障安全。

此外，根据定义，在瞬态数据库中创建的所有架构（以及所有表）都是瞬态的。有关瞬态表的更多信息，请参阅 CREATE TABLE。

默认：无值（即数据库是永久性的）

CLONE source_db

指定创建指定的源数据库的克隆。有关克隆数据库的更多详细信息，请参阅 CREATE <object> ... CLONE。

AT | BEFORE ( TIMESTAMP => timestamp | OFFSET => time_difference | STATEMENT => id )

克隆一个数据库时，AT | BEFORE 子句指定使用 Time Travel 在过去特定时间点或之前克隆该数据库。如果指定的 Time Travel 时间等于或早于数据库创建的时间点，则克隆操作将失败并出现错误。

IGNORE TABLES WITH INSUFFICIENT DATA RETENTION

忽略在 Time Travel 中不再具有可供克隆的历史数据的表。如果 AT | BEFORE 子句中指定的过去时间超出了数据库或架构中任何子表的数据保留期，则跳过子表的克隆操作。有关更多信息，请参阅子对象和数据保留时间。

IGNORE HYBRID TABLES

忽略混合表，不会克隆这些表。使用该选项克隆包含混合表的数据库。克隆的数据库包括其他对象，但会跳过混合表。

如果您不使用此选项，且您的数据库包含一个或多个混合表，该命令将静默忽略混合表。但是，对于包含混合表的数据库的错误处理在即将发布的版本中会发生变化；因此，您可能想要抢先将此参数添加到您的命令中。

DATA_RETENTION_TIME_IN_DAYS = integer

指定可以对数据库执行 Time Travel 操作（CLONE 和 UNDROP）的天数，并指定在数据库中创建的所有架构的默认 Time Travel 保留时间。有关更多详细信息，请参阅了解和使用 Time Travel。

有关此对象级参数的详细说明以及有关对象参数的详细信息，请参阅参数。

值：

Standard Edition：0 或 1

Enterprise Edition：

对于永久数据库为 0 至 90

对于临时数据库为 0 或者 1

默认：

Standard Edition：1

Enterprise Edition（或更高版本）：1 （除非在账户级别指定了不同的默认值）

备注

值为 0 时会有效禁用数据库的 Time Travel。

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

对象参数，用于指定 Snowflake 可以延长数据库中表的数据保留期以防止表上的流过时的最大天数。

有关此参数的详细说明，请参阅 MAX_DATA_EXTENSION_TIME_IN_DAYS。

EXTERNAL_VOLUME = external_volume_name

对象参数，指定要用于 Apache Iceberg™ 表的默认外部卷。

有关此参数的详细信息，请参阅 EXTERNAL_VOLUME。

CATALOG = catalog_integration_name

对象参数，指定要用于 Apache Iceberg™ 表的默认目录集成。

有关此参数的详细信息，请参阅 CATALOG。

REPLACE_INVALID_CHARACTERS = { TRUE | FALSE }

指定在 Iceberg 表的查询结果中是否使用 Unicode 替换字符 (�) 替换无效的 UTF-8 字符。您只能为使用外部 Tables 目录的表设置此参数。

TRUE 会将无效的 UTF-8 字符替换为 Unicode 替换字符。
FALSE 保留无效的 UTF-8 字符不变。如果在 Parquet 数据文件中遇到无效的 UTF-8 字符，Snowflake 会返回用户错误消息。

默认：FALSE

DEFAULT_DDL_COLLATION = 'collation_specification'

为添加到数据库的所有架构和表指定默认排序规则规范。可以在架构和单个表级别上覆盖默认值。

有关该参数的更多详细信息，请参阅 DEFAULT_DDL_COLLATION。

LOG_LEVEL = 'log_level'

指定应引入并在活动事件表中可用的消息的严重级别。引入指定级别（以及更严重级别）的消息。

有关级别的更多信息，请参阅 LOG_LEVEL。有关设置日志级别的信息，请参阅为日志、指标和跟踪设置级别。

TRACE_LEVEL = 'trace_level'

控制如何将跟踪事件引入到事件表中。

有关级别的更多信息，请参阅 TRACE_LEVEL。有关设置跟踪级别的更多信息，请参阅为日志、指标和跟踪设置级别。

STORAGE_SERIALIZATION_POLICY = { COMPATIBLE | OPTIMIZED }

为使用 Snowflake 作为目录的 Apache Iceberg™ 表指定存储序列化策略。

COMPATIBLE：Snowflake 对数据文件执行编码和压缩，可确保与第三方计算引擎的互操作性。
OPTIMIZED：Snowflake 对数据文件执行编码和压缩，可确保 Snowflake 中的最佳表性能。

默认：OPTIMIZED

COMMENT = 'string_literal'

指定数据库的注释。

默认：无值

CATALOG_SYNC = 'snowflake_open_catalog_integration_name'

指定为 Snowflake Open Catalog 配置的目录集成的名称。如果已指定，Snowflake 会将数据库中 Snowflake 管理的 Apache Iceberg™ 表与 Snowflake Open Catalog 账户中的外部目录同步。有关将 Snowflake 管理的 Iceberg 表与 Open Catalog 同步的详细信息，请参阅将 Snowflake 管理的表与 Snowflake Open Catalog 同步。

有关此参数的详细信息，请参阅 CATALOG_SYNC。

默认：无值

CATALOG_SYNC_NAMESPACE_MODE = { NEST | FLATTEN }

指定与 Snowflake Open Catalog 同步的数据库中 Snowflake 管理的 Iceberg 表的目录同步命名空间模式。此属性指定 Snowflake 是否将表同步到具有一个或两个父命名空间的 Open Catalog。它仅适用于您正在设置 CATALOG_SYNC 参数的情况。创建数据库后，您不能更改此属性。

NEST：Snowflake 将两个父命名空间与表同步。

例如，假设您在 Snowflake 中注册了一个 db2.public.table1 Iceberg 表。您要将此表及其两个父命名空间同步到 Open Catalog 中的 catalog2 外部目录。要同步表及其两个父命名空间，请为 CATALOG_SYNC_NAMESPACE_MODE (NEST) 使用默认值。如果不指定 CATALOG_SYNC_NAMESPACE_MODE 属性，则会应用此属性的默认值，即 NEST。因为您为 CATALOG_SYNC_NAMESPACE_MODE 使用默认值，所以不需要指定 CATALOG_SYNC_NAMESPACE_FLATTEN_DELIMITER。因此，Snowflake 将表同步到具有以下完全限定名称的 Open Catalog：catalog2.db2.public.table1。
FLATTEN：Snowflake 将一个父命名空间与表同步，该表包含您使用 CATALOG_SYNC_NAMESPACE_FLATTEN_DELIMITER 属性设置的分隔符。

重要

如果您的第三方查询引擎只能查询目录中位于第二个命名空间级别的表，则必须将 CATALOG_SYNC_NAMESPACE_MODE 属性设置为 FLATTEN。否则，Snowflake 会将 Snowflake 管理的 Iceberg 表同步到 Open Catalog 中的第三个命名空间级别，并且您无法查询该表。

例如，假设您在 Snowflake 中注册了一个 db1.public.table1 Iceberg 表。您希望将此表和一个名为 db1-public 的父命名空间与 Open Catalog 中的 catalog1 外部目录同步，以便此表位于 Open Catalog 中的第二个命名空间级别。

要将表与 db1-public 父命名空间同步，请将 CATALOG_SYNC_NAMESPACE_MODE 设置为 FLATTEN 并指定连字符 (-) 作为 CATALOG_SYNC_NAMESPACE_FLATTEN_DELIMITER 的值。因此，Snowflake 将表同步到具有以下完全限定名称的 Open Catalog：catalog1.db1-public.table1。

默认：NEST

CATALOG_SYNC_NAMESPACE_FLATTEN_DELIMITER = 'string_literal'

指定一个分隔符，当 Snowflake 将 Snowflake 管理的 Iceberg 表同步到具有一个父名称空间的 Snowflake Open Catalog 时，Snowflake 将该分隔符插入最终的展平名称空间。此分隔符属性仅在将 CATALOG_SYNC_NAMESPACE_MODE 属性设置为 FLATTEN 时才适用。Snowflake 插入此分隔符，旨在避免因展平不同表的父命名空间而可能产生的冲突。创建数据库后，您不能更改此属性。

例如，假设您要将 customer.data.table1 和 custom.erdata.table1 Snowflake 管理的 Iceberg 表同步到 Open Catalog 中的 catalog1 外部目录。通过将 CATALOG_SYNC_NAMESPACE_MODE 属性设置为 FLATTEN 并为分隔符指定连字符 (-)，Snowflake 会将这些表与具有以下完全限定名称的 Open Catalog 同步：

catalog1.customer-data.table1

catalog1.custom-erdata.table1

如果将 CATALOG_SYNC_NAMESPACE_MODE 属性设置为 FLATTEN，则需要非空分隔符值。但是，如果您将 CATALOG_SYNC_NAMESPACE_MODE 属性设置为 NEST，则此分隔符属性不适用，并且配置的值将被忽略。

有效字符：0-9、A-Z、a-z、_、$、-

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

指定标签名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅对象的标签配额。

WITH CONTACT ( purpose = contact [ , purpose = contact ...] ): 将新对象与一个或多个联系人关联。

OBJECT_VISIBILITY = { object_visibility_spec | PRIVILEGED }

A YAML specification describing the visibility in one of the following formats:
```
$$
organization_targets:
  - all_accounts_including_external
$$
```
Copy
Or
```
$$
organization_targets:
  - account: <account_name_1>
  - account: <account_name_2>
  - ...
  - organization_user_group: <org_user_group_1>
  - organization_user_group: <org_user_group_2>
$$
```
Copy
In the syntax above:
- all_accounts_including_external: Specifies that all users in all accounts in the organization can see the object. This includes all accounts within the organization, even those to which external parties may have been given access, such as reader accounts.
- account: account_name: Specifies that all users in the specified account can see the object. You can specify multiple accounts. Note that account is the account name, not the account locator. You must specify only the account name, excluding the organization name.09-22
- organization_user_group: org_user_group: Specifies that the specified organization user group can see the object in all accounts in the organization where the organization user group has been imported.
PRIVILEGED: Specifies that only roles within the current account that are granted an explicit privilege on the object can see the object. This is the default behavior in Snowflake.

For examples, see Make database objects discoverable in Universal Search.

ENABLE_DATA_COMPACTION = { TRUE | FALSE }

Specifies whether Snowflake should enable data compaction on Snowflake-managed Apache Iceberg™ 表.

TRUE: Snowflake performs data compaction on the tables.
FALSE: Snowflake doesn't perform data compaction on the tables.

Default: TRUE

For more information, see ENABLE_DATA_COMPACTION and Set data compaction.

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：

权限	对象	备注
CREATE DATABASE	账户	创建新数据库时需要。 Only the SYSADMIN role, or a higher role, has this privilege by default. The privilege can be granted to additional roles as needed.
USAGE	外部卷、目录集成	分别设置 `EXTERNAL_VOLUME` 或 `CATALOG` 对象参数时必需。
IMPORT LISTING	账户	从列表中创建数据库时需要。
IMPORT SHARE	账户	从共享创建数据库时需要。
MANAGE VISIBILITY	账户	Required to set the OBJECT_VISIBILITY property. Only the SECURITYADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
MODIFY LOG LEVEL	账户	为数据库设置 LOG_LEVEL 时需要。
MODIFY TRACE LEVEL	账户	为数据库设置 TRACE_LEVEL 时需要。
OWNERSHIP	数据库	Required when executing an ALTER DATABASE or ALTER SCHEMA statement to set object visibility, or when executing a CREATE OR ALTER DATABASE statement for an existing database. OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

一般使用说明¶

创建数据库会自动将其设置为当前会话的活动/当前数据库（相当于使用数据库的 USE DATABASE 命令）。
如果已存在同名数据库，则返回错误并且不会创建数据库，除非命令中指定了可选的 OR REPLACE 关键字。

重要

使用 OR REPLACE 相当于对现有数据库使用 DROP DATABASE，然后创建一个同名的新数据库；但是，删除的数据库不会从系统中永久移除。相反，它保留在 Time Travel 中。这很重要，因为 Time Travel 中删除的数据库有助于账户的数据存储。有关更多信息，请参阅 Time Travel 和故障安全的存储成本。

The OR REPLACE and IF NOT EXISTS clauses are mutually exclusive. They can't both be used in the same statement.
CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

创建新数据库会自动在数据库中创建两个架构：
- PUBLIC：数据库的默认架构。
- INFORMATION_SCHEMA：包含视图和表函数的架构，可用于查询有关数据库中的对象以及账户中的所有对象的元数据。
从共享创建的数据库与标准数据库在以下方面有所不同：
- 它们没有 PUBLIC 或 INFORMATION_SCHEMA 架构，除非这些架构已显式授予共享。
- 它们无法被克隆。
- 请勿应用 TRANSIENT 和 DATA_RETENTION_TIME_IN_DAYS 等属性。
当数据库处于活动/当前状态时，PUBLIC 架构也默认处于活动/当前状态，除非使用不同的架构或已删除 PUBLIC 架构。
关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

CREATE OR ALTER DATABASE 使用说明¶

ALTER DATABASE 命令的所有限制均适用。
该命令支持 CREATE DATABASE 和 ALTER DATABASE 命令之间重叠的属性和语法。因此，不支持以下操作：
- 使用 SWAP WITH 参数交换数据库。
- 使用 RENAME TO 参数重命名数据库。
- 使用 CLONE 参数创建数据库的克隆。
- 添加或更改标签和策略。任何现有标签和策略都会得到保留。
- 将 TRANSIENT 数据库转换为非 TRANSIENT 数据库，反之亦然。
- 使用以下命令从共享创建数据库：CREATE OR ALTER DATABASE ...FROM SHARE。
- 使用以下命令创建辅助（副本）数据库：CREATE OR ALTER DATABASE ...AS REPLICA OF。

Database Replication 使用说明¶

重要

本节介绍了一种有限的 Database Replication 功能，该功能不同于账户复制功能。Snowflake 强烈建议使用账户复制功能对数据库进行复制和故障转移。

数据库复制使用 Snowflake 提供的计算资源（而不是您自己的虚拟仓库）来复制对象和数据。但是，STATEMENT_TIMEOUT_IN_SECONDS 会话/对象参数仍控制语句在取消之前运行的时间。默认值为 ``172800``（2 天）。由于主数据库的初始复制可能需要 2 天以上的时间才能完成（具体取决于数据库中的元数据量以及数据库对象中的数据量），因此建议将运行复制操作的会话的 STATEMENT_TIMEOUT_IN_SECONDS 值增加到 ``604800``（7 天，最大值）。

在同一会话中执行 ALTER DATABASE secondary_db_name REFRESH 语句之前，请运行以下 ALTER SESSION 语句：
```
ALTER SESSION SET STATEMENT_TIMEOUT_IN_SECONDS = 604800;
```
Copy
请注意，STATEMENT_TIMEOUT_IN_SECONDS 参数也适用于会话中的活动仓库。该参数遵循在会话或仓库级别设置的较低值。如果当前会话中有一个处于活动状态的仓库，也请将此仓库的 STATEMENT_TIMEOUT_IN_SECONDS 设置为 604800 （使用 ALTER WAREHOUSE）。

例如：
```
-- determine the active warehouse in the current session (if any)
SELECT CURRENT_WAREHOUSE();

+---------------------+
| CURRENT_WAREHOUSE() |
|---------------------|
| MY_WH               |
+---------------------+

-- change the STATEMENT_TIMEOUT_IN_SECONDS value for the active warehouse

ALTER WAREHOUSE my_wh SET STATEMENT_TIMEOUT_IN_SECONDS = 604800;
```
Copy
复制操作完成后，您可以将参数值重置为默认值：
```
ALTER WAREHOUSE my_wh UNSET STATEMENT_TIMEOUT_IN_SECONDS;
```
Copy
识别存储主数据库的账户的首选方法是使用组织名称和账户名称作为账户标识符。如果您决定改用旧版账户定位器，请参阅用于复制和故障转移的账户标识符。
CREATE DATABASE ...AS REPLICA 命令不支持 WITH TAG 子句。

此子句不受支持，因为辅助数据库是只读的。如果主数据库指定 WITH TAG 子句，请删除该子句以创建辅助数据库。要验证您的数据库是否存在 WITH TAG 子句，请调用 Snowflake 账户中的 GET_DDL 函数并在函数实参中指定主数据库。如果在数据库上设置了标签，则函数输出将包括 ALTER DATABASE ...SET TAG 语句。

有关更多信息，请参阅复制和标签。

示例¶

创建两个永久数据库，其中一个数据保留期为 10 天：

CREATE DATABASE mytestdb;

CREATE DATABASE mytestdb2 DATA_RETENTION_TIME_IN_DAYS = 10;

SHOW DATABASES LIKE 'my%';

+---------------------------------+------------+------------+------------+--------+----------+---------+---------+----------------+
| created_on                      | name       | is_default | is_current | origin | owner    | comment | options | retention_time |
|---------------------------------+------------+------------+------------+--------+----------+---------+---------+----------------|
| Tue, 17 Mar 2016 16:57:04 -0700 | MYTESTDB   | N          | N          |        | PUBLIC   |         |         | 1              |
| Tue, 17 Mar 2016 17:06:32 -0700 | MYTESTDB2  | N          | N          |        | PUBLIC   |         |         | 10             |
+---------------------------------+------------+------------+------------+--------+----------+---------+---------+----------------+

Copy

创建瞬态数据库：

CREATE TRANSIENT DATABASE mytransientdb;

SHOW DATABASES LIKE 'my%';

+---------------------------------+---------------+------------+------------+--------+----------+---------+-----------+----------------+
| created_on                      | name          | is_default | is_current | origin | owner    | comment | options   | retention_time |
|---------------------------------+---------------+------------+------------+--------+----------+---------+-----------+----------------|
| Tue, 17 Mar 2016 16:57:04 -0700 | MYTESTDB      | N          | N          |        | PUBLIC   |         |           | 1              |
| Tue, 17 Mar 2016 17:06:32 -0700 | MYTESTDB2     | N          | N          |        | PUBLIC   |         |           | 10             |
| Tue, 17 Mar 2015 17:07:51 -0700 | MYTRANSIENTDB | N          | N          |        | PUBLIC   |         | TRANSIENT | 1              |
+---------------------------------+---------------+------------+------------+--------+----------+---------+-----------+----------------+

Copy

使用账户 ab67890 提供的共享创建数据库：

CREATE DATABASE snow_sales FROM SHARE ab67890.sales_s;

Copy

有关使用共享创建数据库的更多详细示例，请参阅使用导入的数据。

Database Replication 示例¶

重要

本节介绍了一种有限的 Database Replication 功能，该功能不同于账户复制功能。Snowflake 强烈建议使用账户复制功能对数据库进行复制和故障转移。

有关创建复制组以将单个数据库复制到目标账户的示例，请参阅复制单个数据库。

CREATE OR ALTER DATABASE 示例¶

创建一个简单的数据库¶

创建名为 db1 的数据库：

CREATE OR ALTER DATABASE db1;

Copy

修改数据库 db1 以设置 DATA_RETENTION_TIME_IN_DAYS 和DEFAULT_DDL_COLLATION 参数：

CREATE OR ALTER DATABASE db1
  DATA_RETENTION_TIME_IN_DAYS = 5
  DEFAULT_DDL_COLLATION = 'de';

Copy

取消先前在数据库上设置的参数¶

如果修改后的数据库定义中缺少以前设置的参数，则会取消设置此参数。在下面的示例中，针对在上一示例中创建的数据库 db1 取消设置 DATA_RETENTION_TIME_IN_DAYS 参数：

CREATE OR ALTER DATABASE db1
  DEFAULT_DDL_COLLATION = 'de';

Copy

备用接口¶

Snowflake REST APIs
Snowflake Python APIs
- database.DatabaseCollection.create 方法
Snowflake CLI
- snow object create 命令

CREATE DATABASE¶

语法¶

变体语法¶

CREATE OR ALTER DATABASE¶

CREATE DATABASE ... CLONE¶

必填参数¶

Secure Data Sharing 参数¶

Database Replication 实参¶

Snapshot parameters¶

列表参数¶

可选参数¶

访问控制要求¶

一般使用说明¶

CREATE OR ALTER DATABASE 使用说明¶

Database Replication 使用说明¶

示例¶

Database Replication 示例¶

CREATE OR ALTER DATABASE 示例¶

创建一个简单的数据库¶

取消先前在数据库上设置的参数¶

备用接口¶