Release v0.11.5 (#222)

docs/source/base-tables.rst

@@ -20,6 +20,13 @@
    for table in o.list_tables():
        print(table.name)
 
+可以通过 ``prefix`` 参数只列举给定前缀的表：
+
+.. code-block:: python
+
+   for table in o.list_tables(prefix="table_prefix"):
+       print(table.name)
+
 通过该方法获取的 Table 对象不会自动加载表名以外的属性，此时获取这些属性（例如 ``table_schema`` 或者
 ``creation_time``）可能导致额外的请求并造成额外的时间开销。如果需要在列举表的同时读取这些属性，在
 PyODPS 0.11.5 及后续版本中，可以为 ``list_tables`` 添加 ``extended=True`` 参数：
@@ -29,6 +36,15 @@ PyODPS 0.11.5 及后续版本中，可以为 ``list_tables`` 添加 ``extended=T
    for table in o.list_tables(extended=True):
        print(table.name, table.creation_time)
 
+如果你需要按类型列举表，可以指定 ``type`` 参数。不同类型的表列举方法如下：
+
+.. code-block:: python
+
+   managed_tables = list(o.list_tables(type="managed_table"))  # 列举内置表
+   external_tables = list(o.list_tables(type="external_table"))  # 列举外表
+   virtual_views = list(o.list_tables(type="virtual_view"))  # 列举视图
+   materialized_views = list(o.list_tables(type="materialized_view"))  # 列举物化视图
+
 通过调用 ``exist_table`` 来判断表是否存在。
 
 .. code-block:: python

docs/source/df-element.rst

@@ -591,8 +591,10 @@ UDF，则map函数无法使用。除此以外，所有 Python UDF 的限制在
 现在用户可以把第三方 Wheel 包作为资源上传到 MaxCompute。在全局或者在立即执行的方法时，指定需要使用的包文件，
 即可以在自定义函数中使用第三方库。值得注意的是，第三方库的依赖库也必须指定，否则依然会有导入错误。
 
-PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。同时，execute / persist / to_pandas
-方法支持增加 ``libraries`` 参数以使用这些资源。如何制作及使用三方包的说明请参考 :ref:`这里 <pyodps_pack>`。
+如果你的 MaxCompute 服务支持在执行 SQL 时使用镜像，可以在 execute / persist / to_pandas 方法指定 ``image``
+参数以使用镜像。与此同时，DataFrame 的 execute / persist / to_pandas 方法支持增加 ``libraries`` 参数以将资源作为三方包。
+PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。如何制作及使用三方包的说明请参考
+:ref:`这里 <pyodps_pack>`。
 
 .. warning::
     由于字节码定义的差异，Python 3 下使用新语言特性（例如 ``yield from`` ）时，代码在使用 Python 2.7 的 ODPS

docs/source/df-sort-distinct-apply.rst

@@ -568,8 +568,10 @@ apply 的自定义函数接收一个参数，为上一步 Collection 的一行
 现在用户可以把第三方 Wheel 包作为资源上传到 MaxCompute。在全局或者在立即执行的方法时，指定需要使用的包文件，
 即可以在自定义函数中使用第三方库。值得注意的是，第三方库的依赖库也必须指定，否则依然会有导入错误。
 
-PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。同时，execute / persist / to_pandas
-方法支持增加 ``libraries`` 参数以使用这些资源。如何制作及使用三方包的说明请参考 :ref:`这里 <pyodps_pack>`。
+如果你的 MaxCompute 服务支持在执行 SQL 时使用镜像，可以在 execute / persist / to_pandas 方法指定 ``image``
+参数以使用镜像。与此同时，DataFrame 的 execute / persist / to_pandas 方法支持增加 ``libraries`` 参数以将资源作为三方包。
+PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。如何制作及使用三方包的说明请参考
+:ref:`这里 <pyodps_pack>`。
 
 .. warning::
     由于字节码定义的差异，Python 3 下使用新语言特性（例如 ``yield from`` ）时，代码在使用 Python 2.7 的 ODPS
@@ -686,8 +688,10 @@ combiner表示在map_reduce API里表示在mapper端，就先对数据进行聚
 现在用户可以把第三方 Wheel 包作为资源上传到 MaxCompute。在全局或者在立即执行的方法时，指定需要使用的包文件，
 即可以在自定义函数中使用第三方库。值得注意的是，第三方库的依赖库也必须指定，否则依然会有导入错误。
 
-PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。同时，execute / persist / to_pandas
-方法支持增加 ``libraries`` 参数以使用这些资源。如何制作及使用三方包的说明请参考 :ref:`这里 <pyodps_pack>`。
+如果你的 MaxCompute 服务支持在执行 SQL 时使用镜像，可以在 execute / persist / to_pandas 方法指定 ``image``
+参数以使用镜像。与此同时，DataFrame 的 execute / persist / to_pandas 方法支持增加 ``libraries`` 参数以将资源作为三方包。
+PyODPS 提供了 ``pyodps-pack`` 工具，可在安装完 PyODPS 后打包三方包及其依赖。如何制作及使用三方包的说明请参考
+:ref:`这里 <pyodps_pack>`。
 
 .. warning::