配置账本数据库

适用于：SQL Server 2022 (16.x) Azure SQL 数据库 Azure SQL 托管实例

本文提供有关使用 Azure 门户、T-SQL、PowerShell 或适用于 Azure SQL 数据库的 Azure CLI 配置账本数据库的信息。 有关在 SQL Server 2022 (16.x) 或 Azure SQL 托管实例中创建账本数据库的信息，请使用此页面顶部的开关。

先决条件

• 拥有一个有效的 Azure 订阅。 如果没有帐户，请创建一个免费帐户。
• 一个逻辑服务器。

启用账本数据库

注意

在数据库级别上启用账本功能，将创建此数据库可更新账本表中的所有表。 创建数据库后，无法更改此选项。 使用选项 LEDGER = OFF 创建表将会引发错误消息。

Portal

1. 打开 Azure 门户并创建 Azure SQL 数据库。

2. 在“安全”选项卡上，选择“配置账本”。

   

3. 在“配置账本”窗格中，选择“为此数据库中所有将来的表启用”。

   

4. 选择“应用”以保存设置。

T-SQL

使用 T-SQL 启用账本数据库

在 Visual Studio 中打开查询编辑器，例如 SQL Server Management Studio (SSMS)、Azure Data Studio 或 SQL Server Data Tools (SSDT)，并连接到逻辑 SQL Server。 以下示例创建一个常规用途数据库。 WITH LEDGER=ON 子句将创建账本数据库。

CREATE DATABASE Database01
	(
	  EDITION = 'GeneralPurpose',
	  SERVICE_OBJECTIVE='GP_Gen5_2',
	  MAXSIZE = 2 GB
	)
	WITH LEDGER = ON;
GO 

PowerShell

使用 PowerShell 启用账本数据库

使用 New-AzSqlDatabase cmdlet 创建单一账本数据库。 以下示例创建无服务器数据库。 参数 - EnableLedger 将创建账本数据库。 注意：请确保修改参数 ServerName 和 DatabaseName

Write-host "Creating a gen5 2 vCore serverless ledger database..."
$database = New-AzSqlDatabase  -ResourceGroupName $resourceGroupName `
    -ServerName "Server01" `
    -DatabaseName "Database01" `
    -Edition GeneralPurpose `
    -ComputeModel Serverless `
    -ComputeGeneration Gen5 `
    -VCore 2 `
    -MinimumCapacity 2 `
    -EnableLedger
$database

Azure CLI

使用 Azure CLI 启用账本数据库

使用 az sql db create 命令创建账本数据库。 以下命令创建启用了账本的无服务器数据库。 注意：请确保修改参数资源组、服务器和名称

az sql db create \
    --resource-group ResourceGroup01 \
    --server Server01 \
    --name Database01 \
    --edition GeneralPurpose \
    --family Gen5 \
    --capacity 2 \
    --compute-model Serverless \
    --ledger-on

本文提供有关使用 T-SQL、PowerShell 或适用于 Azure SQL 托管实例的 Azure CLI 来配置账本数据库的信息。 有关在 SQL Server 2022 (16.x) 或 Azure SQL 数据库中创建账本数据库的信息，请使用此页面顶部的开关切换。

先决条件

• 拥有一个有效的 Azure 订阅。 如果没有帐户，请创建一个免费帐户。
• Azure SQL 托管实例。

启用账本数据库

注意

在数据库级别上启用账本功能，将创建此数据库可更新账本表中的所有表。 创建数据库后，无法更改此选项。 使用选项 LEDGER = OFF 创建表将会引发错误消息。

T-SQL

使用 T-SQL 启用账本数据库

1. 使用 SQL Server Management Studio（SSMS）、Azure Data Studio 或 SQL Server Data Tools（SSDT）登录到你的托管实例。

2. 使用以下 T-SQL 语句创建账本数据库：

   CREATE DATABASE MyLedgerDB  WITH LEDGER = ON;
   

有关详细信息，请参阅创建数据库 (Transact-SQL)。

PowerShell

使用 PowerShell 启用账本数据库

使用 New-AzSqlDatabase cmdlet 创建单个账本数据库。 以下示例可在 SQL Server 实例上创建一个账本数据库。 参数 -EnableLedger 创建账本数据库。 请确保修改参数 ResourceGroupName、InstanceName 和 Name。

Write-host "Creating a ledger database..."
$database = New-AzSqlInstanceDatabase -ResourceGroupName "ResourceGroup01" `
    -InstanceName  "ManagedInstance1" `
    -Name "Database01" `
    -EnableLedger
$database

Azure CLI

使用 Azure CLI 启用账本数据库

使用 az sql midb create 命令创建账本数据库。 以下示例可在指定的实例上创建账本数据库。 请确保修改参数 resource-group、managed-instance 和 name。

az sql midb create \
    --resource-group ResourceGroup01 \
    --managed-instance Server01 \
    --name Database01 \
    --ledger-on

本文提供有关使用 T-SQL 创建账本数据库（在 SQL Server 2022 (16.x) 中）的信息。 有关在 Azure SQL 数据库中创建账本数据库的信息，请使用此页面顶部的开关。

先决条件

• SQL Server 2022 (16.x)
• SQL Server Management Studio (SSMS)、Azure Data Studio 或 SQL Server Data Tools

使用 T-SQL 创建账本数据库

1. 使用 SSMS、Azure Data Studio 或 SSDT 登录到 SQL Server 2022 (16.x) 实例。

2. 使用以下 T-SQL 语句创建账本数据库：

   CREATE DATABASE MyLedgerDB  WITH LEDGER = ON;
   

有关详细信息，请参阅创建数据库 (Transact-SQL)。

相关内容

• 账本概述
• 仅追加账本表
• 可更新账表
• 启用自动摘要存储