redturtle.sqlcontents 0.9.1

免责声明

redturtle.sqlcontens 是一个 危险的 包。

在使用它之前请仔细阅读文档。尽管这个包是开发来执行“SELECT”查询的，但它接受任何类型的查询而不进行验证。在当前的开发状态下，您甚至可以 从您的数据库中删除内容，这是 危险 和 邪恶 的。

安全提示：如果可能的话，最好使用只读帐户访问外部数据库。这可以 拯救世界！

不要查询大量数据或大对象，redturtle.sqlcontents 并未为此任务设计！

请注意，长时间查询或网络问题可能会导致您的实例线程 锁定！

简介

本包的开发是为了满足在Plone中使用SQLAlchemy执行和展示简单SQL查询的需求。

它为您的Plone站点引入了两个架构类型

• SQLFolder

• SQLQuery

有了这些内容，您可以在Plone页面上显示查询返回的数据。

描述

SQLFolder

SQLFolder对象可以全局添加，可以包含SQLQuery对象。SQLFolder具有一个connection_url字段，您可以在其中指定如何通过SQLAlchemy连接到外部数据库。请参阅SQLAlchemy文档）。

SQLQuery

在SQLFolder内部，您可以创建SQLQueries，文档类型对象，其中包含一个字段query。在这个字段中，您可以指定任何类型的查询到数据库，没有约束，即使它似乎是一个SELECT。

SQLQuery对象的默认视图从您的查询结果中获取数据，并以分页表格的形式展示。表格的标题默认由列名组成，但您可以通过正确填写字段column_names来定义替换映射。

安装

将redturtle.sqlcontents添加到您的实例的egg部分

[instance]
eggs=
    ...
    redturtle.sqlcontents
    ...

为了使与您选择的数据库服务器的连接有效，您可能需要安装（使用系统工具或buildout）适当的库，例如

• MySQL-python

• cx_Oracle

• psycopg2

• python-sqlite

在旧版本的Plone（3.3.2之前的版本）中，您需要在zcml部分中做同样的事情。

注意

redturtle.sqlcontents已在Plone 3.3.4和Plone 4.2上进行了测试。我假设与中间版本兼容。

redturtle.sqlcontents依赖于

• SQLAlchemy

• Products.DataGridField

这些软件包由redturtle.sqlcontents自动包含在您的buildout中，因此您不必担心它们。

在Plone 3安装中，您可能希望将Products.DataGridField锁定在低于1.7的版本（1.6.2是编写时的正确版本）。

作者

此产品由RedTurtle技术团队开发。