SQL API 简介

Snowflake SQL API 是一个 REST API，您可以使用它来访问和更新 Snowflake 数据库中的数据。您可以用此 API 开发可执行以下操作的自定义应用程序和集成：

  • 执行查询。

  • 管理部署（例如，预置用户和角色、创建表等）。

本主题内容：

SQL API 的功能

Snowflake SQL API 提供可用于以下目的的操作：

  • 提交 SQL 语句以供执行。

  • 检查语句的执行状态。

  • 取消执行语句。

  • 并发提取查询结果。

您可以用此 API 执行 标准查询 和大多数 DDL 及 DML 语句。请参阅 SQL API 的限制，了解不支持的语句类型。

对于查询， SQL API 返回分区中的数据。Snowflake 确定返回的分区数以及每个分区的大小。

SQL API (/api/v2/statements) 的端点受 网络策略 保护，这些策略限制对启用 API 的账户的访问。

备注

无论在用户或账户级别设置了什么值，每个查询或语句级别的 AUTOCOMMIT 参数都必须设置为 TRUE。

SQL API 的限制

SQL API 有以下限制：

  • 不支持以下命令：

    • PUT 命令（在 Snowflake SQL 中）

    • GET 命令（在 Snowflake SQL 中）

以下命令和语句仅在 :doc:` 指定多个语句的请求 <submitting-multiple-statements>` 中受支持：

  • 执行显式事务的命令，包括：

  • 更改会话上下文的命令，包括：

  • 设置会话变量的语句。

  • 创建临时表和暂存区（仅在当前会话中可用的表和暂存区）的语句。

SQL API 目前不支持 Python 存储过程。

使用 SQL API 时的计费注意事项

SQL API 在提取一些查询结果时利用云服务层。有关云服务的更多信息，请参阅 云服务 Credit 使用情况。

语言: 中文