HTSQL-DJANGO 2.3.3

安装和使用

此软件包允许你在Django项目中使用HTSQL。要安装它，运行

# pip install HTSQL-DJANGO

此命令安装HTSQL本身和Django网关。默认情况下，HTSQL与SQLite数据库一起工作。要在其他数据库服务器上运行HTSQL，请安装额外的数据库后端

# pip install HTSQL-PGSQL
# pip install HTSQL-MYSQL

要在Django项目中使用HTSQL，打开 settings.py 并将 'htsql_django' 添加到已安装应用程序列表中

INSTALLED_APPS = (
    # ...
    'htsql_django',
)

在Django项目中使用时，HTSQL服务将自动配置为在默认Django数据库上提供服务。你可以使用 HTSQL_CONFIG 参数提供额外的配置选项。例如，一个合理的配置可能是

HTSQL_CONFIG = {
    # Set query timeout in seconds (currently, PostgreSQL only).
    'tweak.timeout': { 'timeout': 600 },
    # Set the maximum number of output rows.
    'tweak.autolimit': { 'limit': 10000 },
    # Enable the web-based query editor.
    'tweak.shell.default': {},
    # Enable meta-data queries.
    'tweak.meta': {},
}

接下来，将网关添加到URL分发器。打开 urls.py 并添加以下行

urlpatterns = patterns('',
    # ...
    url(r'^htsql/', include('htsql_django.urls')),
)

这将把从 /htsql/ 开始的HTTP请求转发到HTSQL服务。网关仅对认证用户可用。

你还可以从Python代码中执行HTSQL查询。例如，为了计算Django教程项目中每个投票的总数，运行

>>> from htsql_django import produce
>>>
>>> query = "/polls_poll{question, total:=sum(polls_choice.votes)}"
>>> for row in produce(query):
...     print "%s: %s" % (row.question, row.total)
...
What's up?: 6