SQL、工作簿和 SQL 历史

使用 Product SDK 浏览 SQL 元数据、管理工作簿和版本、运行 SQL，并查看查询与语句结果。SQL 文本、运行上下文和目标对象均由调用方提供；SDK 不会从文本推断工作簿、查询或语句的 ID。

使用流程

  1. 从 SQL 元数据中选择数据库和表，或使用已确认的对象标识。

  2. 创建或绑定工作簿及其版本。

  3. 使用明确的 SQL 文本和运行上下文提交查询。

  4. 保存返回的查询和语句标识，并通过相应 SDK 对象查看结果、详情、性能信息或 SQL 历史。

提交 SQL 不代表已取得完整结果。结果可能需要继续读取，并且写入、删除或 DDL 语句会影响数据；请在运行前确认语句、目标工作区和权限。

SDK 调用

metadata := workspace.SQLMetadata()
databases, err := metadata.Databases(ctx)
workbook, _, err := workspace.CreateSQLWorkbook(ctx, workbookName)
query, _, err := workspace.ExecuteSQL(
	ctx, sqlText, sdk.WithSQLQueryDBName(databaseName),
)
statement, err := workspace.SQLStatement(statementID)
rows, err := statement.Result(ctx, sdk.WithSQLResultLimit(resultLimit))

metadata = workspace.sql_metadata()
databases = metadata.databases()
workbook, created = workspace.create_sql_workbook(workbook_name)
query, started = workspace.execute_sql(
    sql_text, sdk.with_sql_query_db_name(database_name)
)
statement = workspace.sql_statement(statement_id)
rows = statement.result(sdk.with_sql_result_limit(result_limit))

query、statement 和 rows 分别对应查询、语句和结果读取。保存服务端返回的标识，后续再查看详情或 SQL 历史。

下一步

最后更新于