将块存储卷与服务一起使用¶

第 1 步：定义块存储卷¶

指定 spec.volumes 字段以定义要创建的块存储卷。

spec:
  containers:
  ...
  volumes:
    - name: <name>
      source: block
      size: <size-in-Gi>
      blockConfig:                             # optional
        initialContents:
          fromSnapshot: <snapshot-name>
        iops: <number-of-operations>
        throughput: <MiB-per-second>
        encryption: SNOWFLAKE_SSE | SNOWFLAKE_FULL

以下字段为必填字段：

• name：卷的名称。

• source：卷的类型。对于块存储卷，值为 block。

• size：块存储卷的存储容量，以字节为计量单位。值必须始终为整数（使用 Gi 单位后缀指定）。例如，5Gi 表示 5*1024*1024*1024 字节。云提供商的大小值范围：

  • 1Gi to 65536Gi for AWS.

  • 1Gi to 16384Gi for Azure.

  • 对于 Google Cloud，为 4Gi 至 16384Gi。

以下是可选字段：

• blockConfig.initialContents.fromSnapshot：指定先前拍摄的另一个卷的快照以初始化块卷。快照名称可以是 完全限定的对象标识符，例如 TUTORIAL_DB.DATA_SCHEMA.MY_SNAPSHOT。此外，快照名称是相对于服务的数据库和架构解析的。例如，如果您在 TUTORIAL_DB.DATA_SCHEMA 中创建了服务，则 fromSnapshot: MY_SNAPSHOT 等效于 fromSnapshot: TUTORIAL_DB.DATA_SCHEMA.MY_SNAPSHOT。

  请注意以下事项：

  • 快照必须处于 CREATED 状态，才能用于创建卷，否则服务创建将失败。

  • 快照的加密类型必须与正在创建的卷的加密类型匹配。

  使用 DESCRIBE SNAPSHOT 命令获取快照的状态和加密类型。

• blockConfig.iops：指定支持的每秒输入/输出操作峰值数量。请注意，每次操作的数据大小上限为 256 KiB。

  • For AWS: The supported range is 3000-80000, with a default of 3000.

  • 对于 Azure：支持范围为 3000-80000，默认值为 3000。

  • 对于 Google Cloud：

    • Google Cloud CPU instances: The supported range is 2000-160000, with the following defaults:

      • 2000 IOPS（适用于 4 Gi 磁盘大小）

      • 2500 IOPS（适用于 5 Gi 磁盘大小）

      • 3000 IOPS（适用于所有其他磁盘大小）

    • Google Cloud GPU 实例：Snowflake 建议仅指定吞吐量。对于 Google Cloud 中的 GPU 实例，blockConfig.iops 必须为 16 * blockConfig.throughput。

• blockConfig.throughput：指定为卷配置的峰值吞吐量，单位为 MiB/秒。

  • For AWS: The supported range is 125 - 2000, with a default of 125.

  • 对于 Azure：支持范围为 125-1200，默认值为 125。

  • 对于 Google Cloud：

    • Google Cloud CPU 实例：支持范围为 140-2400，默认值为 140。

    • Google Cloud GPU 实例：支持范围为 400-1,200,000，默认值为 400，但每 GB 卷大小不小于 0.12。

• blockConfig.encryption：指定卷的加密类型：SNOWFLAKE_SSE 或 SNOWFLAKE_FULL。有关更多信息，请参阅 加密支持。

第 2 步：指定在容器中挂载卷的位置¶

在通过添加 spec.volumes 字段定义块存储卷后，请使用 spec.containers.volumeMounts 字段描述在应用程序容器中挂载该卷的位置，如下例所示：

spec:
  containers:
  - name: ...
    image: ...
    volumeMounts:
    - name: <volume-name>
      mountPath: <absolute_directory_path>

示例¶

• 创建一个带有 10Gi 块存储卷的服务。该卷挂载在主容器的 /opt/block/path 路径下。

  CREATE SERVICE my_service
  IN COMPUTE POOL tutorial_compute_pool
  FROM SPECIFICATION $$
  spec:
    containers:
    - name: echo
      image: /tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest
      volumeMounts:
      - name: block-vol
        mountPath: /opt/block/path
      readinessProbe:
        port: 8080
        path: /healthcheck
    endpoints:
    - name: echoendpoint
      port: 8080
      public: true
    volumes:
    - name: block-vol
      source: block
      size: 10Gi
  $$;
  

  Copy

• 创建一个使用快照初始化的块存储卷服务。

  CREATE SERVICE new_service
    IN COMPUTE POOL tutorial_compute_pool
    FROM SPECIFICATION $$
  spec:
    containers:
    - name: echo
      image: /tutorial_db/data_schema/tutorial_repository/my_echo_service_image:tutorial
      volumeMounts:
      - name: vol-from-snapshot
        mountPath: /opt/block/path
      readinessProbe:
        port: 8080
        path: /healthcheck
    endpoints:
    - name: echoendpoint
      port: 8080
      public: true
    volumes:
    - name: vol-from-snapshot
      source: block
      size: 50Gi
      blockConfig:
        initialContents:
          fromSnapshot: BACKUP_DB.SNAPSHOTS.MY_SNAPSHOT
  $$
  

  Copy

有关包含分步说明的示例，请参阅 教程 5：创建已挂载块存储卷的服务。本教程将向您演示如何创建一个挂载了块存储卷的服务。

关于 IOPS 和吞吐量¶

如果您的服务 IO 性能没有达到预期，并且服务受到块卷 IO 或吞吐量的影响，您可以考虑增加 IOPS 或吞吐量。在当前实施中，任何此类更改都需要您重新创建服务。

您可以查看以下 可用的平台指标，以确定您的服务是否在块存储上遇到瓶颈：

• container.cpu.usage

• volume.read.iops

• volume.write.iops

• volume.read.throughput

• volume.write.throughput

根据云提供商的不同，需注意以下事项：

• 为 AWS 配置 IOPS 和吞吐量：

  • The maximum IOPS that can be configured is 500 IOPS per GiB of volume size, to a maximum of 80,000 IOPS. For example, the maximum IOPS of a 10 GiB volume can be 500 * 10 = 5000. Accordingly, note that the maximum IOPS of 80,000 can only be configured if your volume is 160 GiB or larger.

  • The maximum throughput that can be configured is 1 MiB/second for every 4 IOPS, to a maximum of 2000 MiBs/second. For example, with the default 3000 IOPS you can configure throughput up to 750 MiB/second (3000/4=750).

• 为 Azure 配置 IOPS 和吞吐量：

  • 在卷大小达到 6 GB 后，超出 6 GB 的每 GB（磁盘类型）所支持的 IOPS 数量将增加 500。10GB 卷的最大 IOPS 可以是 500 * 4 + 3000 = 5000。因此，请注意，只有在卷为 160 GiB 或更大时，才能配置最大 IOPS 80000。

  • 6 GB 后，可配置的最大吞吐量是每 IOPS 为 0.25 MiB/秒，最大为 1200 MiBs/秒。例如，使用默认的 3000 IOPS，您可以配置高达 750 MiB/秒的吞吐量 (3000*0.25=750)。

• 为 Google Cloud 配置 IOPS 和吞吐量：

  • 对于 CPU 实例：

    • IOPS 可配置为每 Gi 卷大小 500 IOPS，最大为 160,000 IOPS。例如，10 Gi 卷可以达到最大 5,000 IOPS (500 IOPS * 10 Gi)。要达到最大 160,000 IOPS，卷大小必须为 320 Gi 或更大。

    • 可以配置 2400 MiB/秒的最大吞吐量，每 4 IOPS 的速率为 1 MiB/秒。例如，3000 IOPS 支持高达 750 MiB/秒的吞吐量 (3000 / 4 = 750)。

  • 对于 GPU 实例：

    • IOPS 不能独立于吞吐量进行设置；IOPS 的计算方法为 16 乘以吞吐量值。因此，指定吞吐量会自动确定 IOPS。对于与 GPU 实例一起使用的磁盘，不建议配置 IOPS。

    • 您必须配置最低吞吐量。对于每 GiB 的卷大小，吞吐量必须至少为 400 MiB/s，或者 0.12 MiB/s，以较高者为准。

    • 对于每 GiB 的卷大小，可配置的吞吐率为 1600 MiB/s，最大值为 1200,000 MiB/s。例如，一个 10 GiB 卷可以实现最大吞吐量 16,000 MiB/s (1600 * 10)。请注意，仅当卷为 750 GiB 或更大时，才能达到 1,200,000 MiB/s 的上限。

删除时生成快照¶

执行以下任一命令都会导致删除与服务关联的块卷：

• DROP SERVICE <service-name> FORCE

• ALTER COMPUTE POOL <compute-pool-name> STOP ALL

• ALTER SERVICE <service-name> RESTORE VOLUME <volume-name> FROM SNAPSHOT

The snapshotOnDelete option defaults to true for services and false for jobs. When the value is true, Snowflake takes a snapshot of the volume before deletion, to protect you from accidental data loss. You add this option in the service specification as part of the blockConfig configuration.

与其他快照不同，这些快照会在一段时间后自动删除。快照保留期默认为 7 天，可以使用 snapshotDeleteAfter 字段进行配置。

Snowflake 按以下格式分配快照名称：SYS_BACKUP_ON_DELETE<string>_<timestamp>。