数据库 · 函数

SQL选择

构建 SQL SELECT 表达式。

调用签名

(列列表=None, 来源=None, 条件=None, 分组=None, 排序=None, 限制=None, 偏移=None, 去重: 'bool' = False, **选项)

SZHONGWEN
PYTHON

Chinese example

中文代码示例

# 完整案例：按字段调用 SQL选择
设 结果 = 数据库.SQL选择(
    列列表=None,  # 可选；Pandas DataFrame 或类似表格对象
    来源=None,  # 可选；按函数业务含义传入 来源;首次使用建议先 打印(...
    条件=None,  # 可选；按函数业务含义传入 条件;首次使用建议先 打印(...
    分组=None,  # 可选；按函数业务含义传入 分组;首次使用建议先 打印(...
    排序=None,  # 可选；排序字段或排序方式,如 升序 / 降序
    限制=None,  # 可选；返回最大条数,用于控制结果规模
    偏移=None,  # 可选；数据起点偏移量,用于分页或跳过前 N 项
    去重=False,  # 可选；布尔开关 去重,传 真 或 假 控制行为;不传时...
    **{"字段": "值"},  # 可选；额外关键字参数，用字典形式展开传入
)
打印(结果)

可直接放进 .cs / .中py 文件运行。转换器会把中文代码交给真实 Python 解释器。

Parameters

参数说明

9 个参数

参数类型 / 传入方式说明

列列表可选 · 默认 None

未声明位置参数或字段名=值

Pandas DataFrame 或类似表格对象。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

来源可选 · 默认 None

未声明位置参数或字段名=值

按函数业务含义传入来源;首次使用建议先打印(结果) 确认其作用。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

条件可选 · 默认 None

未声明位置参数或字段名=值

按函数业务含义传入条件;首次使用建议先打印(结果) 确认其作用。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

分组可选 · 默认 None

未声明位置参数或字段名=值

按函数业务含义传入分组;首次使用建议先打印(结果) 确认其作用。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

排序可选 · 默认 None

未声明位置参数或字段名=值

排序字段或排序方式,如升序 / 降序。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

限制可选 · 默认 None

未声明位置参数或字段名=值

返回最大条数,用于控制结果规模。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

偏移可选 · 默认 None

未声明位置参数或字段名=值

数据起点偏移量,用于分页或跳过前 N 项。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

去重可选 · 默认 False

bool位置参数或字段名=值

布尔开关去重,传真或假控制行为;不传时按默认值。

常见错误：传非布尔会报 TypeError;用真/假或 True/False

选项可选 · 默认不传则为空

未声明可变关键字参数，用 **字典展开

额外关键字参数，用字典形式展开传入。

常见错误：类型不匹配会报 TypeError;按字段类型列传值,首次使用建议先打印(结果) 确认结构

Playbook

基础用法 · 进阶组合 · 错误排查

# 完整案例：按字段调用 SQL选择
设 结果 = 数据库.SQL选择(
    列列表=None,  # 可选；Pandas DataFrame 或类似表格对象
    来源=None,  # 可选；按函数业务含义传入 来源;首次使用建议先 打印(...
    条件=None,  # 可选；按函数业务含义传入 条件;首次使用建议先 打印(...
    分组=None,  # 可选；按函数业务含义传入 分组;首次使用建议先 打印(...
    排序=None,  # 可选；排序字段或排序方式,如 升序 / 降序
    限制=None,  # 可选；返回最大条数,用于控制结果规模
    偏移=None,  # 可选；数据起点偏移量,用于分页或跳过前 N 项
    去重=False,  # 可选；布尔开关 去重,传 真 或 假 控制行为;不传时...
    **{"字段": "值"},  # 可选；额外关键字参数，用字典形式展开传入
)
打印(结果)

# 进阶组合:SQL选择 配合 数据库 业务流使用
设 连接 = 数据库.连接SQLite(":memory:")
设 结果 = 数据库.SQL选择(
    列列表=None,  # 可选
    来源=None,  # 可选
    条件=None,  # 可选
)
数据库.关闭(连接)
打印(结果)

# 错误排查:类型不匹配
# 错误:传错类型
# 设 结果 = 数据库.SQL选择(列列表=None)  # TypeError
# 修复:按字段类型 未声明 传值
设 结果 = 数据库.SQL选择(列列表=None)
打印(结果)