• Greenplum数据库不支持PL/Python触发器。
• PL/Python仅作为Greenplum数据库不可信语言提供。
• 不支持可更新游标（UPDATE ... WHERE CURRENT OF和DELETE ... WHERE CURRENT OF）。

对于需要使用它的每个数据库，使用SQL命令CREATE EXTENSION注册PL/Python语言。 由于PL/Python是一种不受信任的语言，因此只有超级用户才能将PL/Python注册到数据库中。 例如，当gpadmin用户使用名为testdb的数据库注册PL/Python时，运行此命令：

$ psql -d testdb -c 'CREATE EXTENSION plpythonu;'

PL/Python注册为不受信任的语言。

对于不再需要PL/Python语言的数据库，请使用SQL命令DROP EXTENSION删除对PL/Python的支持。 由于PL/Python是一种不受信任的语言，因此只有超级用户才能从数据库中删除对PL/Python语言的支持。 例如，以gpadmin用户身份运行此命令将从名为testdb的数据库中删除对PL/Python的支持：

$ psql -d testdb -c 'DROP EXTENSION plpythonu;'

如果任何现有对象（如函数）依赖于语言，则默认命令将失败。 指定CASCADE选项也可以删除所有依赖对象，包括使用PL/Python创建的函数。

使用Python列表将SQL数组值传递到PL/Python函数中。 类似地，PL/Python函数将SQL数组值作为Python列表返回。 在典型的PL/Python使用模式中，您将使用[]指定数组。

以下示例创建一个返回整数数组的PL/Python函数：

CREATE FUNCTION return_py_int_array()
  RETURNS int[]
AS $$
  return [1, 11, 21, 31]
$$ LANGUAGE plpythonu;

SELECT return_py_int_array();
 return_py_int_array 
---------------------
 {1,11,21,31}
(1 row) 

PL/Python将多维数组视为列表列表。 使用嵌套的Python列表将多维数组传递给PL/Python函数。 当PL/Python函数返回一个多维数组时，每个级别的内部列表必须都具有相同的大小。

以下示例创建一个PL/Python函数，该函数将多维数组的整数作为输入。 该函数显示提供的参数的类型，并返回多维数组：

CREATE FUNCTION return_multidim_py_array(x int4[]) 
  RETURNS int4[]
AS $$
  plpy.info(x, type(x))
  return x
$$ LANGUAGE plpythonu;

SELECT * FROM return_multidim_py_array(ARRAY[[1,2,3], [4,5,6]]);
INFO:  ([[1, 2, 3], [4, 5, 6]], <type 'list'>)
CONTEXT:  PL/Python function "return_multidim_py_type"
 return_multidim_py_array 
--------------------------
 {{1,2,3},{4,5,6}}
(1 row) 

PL/Python还接受其他Python序列（如元组）作为函数参数，以便向后兼容不支持多维数组的Greenplum版本。 在这种情况下，Python序列始终被视为一维数组，因为它们与复合类型不一致。

使用Python映射将复合类型参数传递给PL/Python函数。 映射的元素名称是复合类型的属性名称。 如果属性具有空值，则其映射值为None。

您可以将复合类型结果作为序列类型（元组或列表）返回。 在多维数组中使用复合类型时，必须将复合类型指定为元组，而不是列表。 您不能将复合类型数组作为列表返回，因为确定列表是表示复合类型还是其他数组维度是不明确的。 在典型的使用模式中，您将使用()指定复合类型元组。

在以下示例中，您将创建一个复合类型和一个返回复合类型数组的PL/Python函数：

CREATE TYPE type_record AS (
  first text,
  second int4
);

CREATE FUNCTION composite_type_as_list()
  RETURNS type_record[]
AS $$              
  return [[('first', 1), ('second', 1)], [('first', 2), ('second', 2)], [('first', 3), ('second', 3)]];
$$ LANGUAGE plpythonu;

SELECT * FROM composite_type_as_list();
                               composite_type_as_list                           
------------------------------------------------------------------------------------
 {{"(first,1)","(second,1)"},{"(first,2)","(second,2)"},{"(first,3)","(second,3)"}}
(1 row) 

有关PL/Python处理数组和复合类型的其他信息，请参阅PostgreSQL数组，列表文档。

PL/Python plpy模块提供了两个Python函数来执行SQL查询并为查询plpy.execute和plpy.prepare准备执行计划。 如果从多个Python函数运行查询，则为查询准备执行计划很有用。

PL/Python还支持plpy.subtransaction()函数，以帮助在显式子事务中管理plpy.execute调用。 有关plpy.subtransaction()的其他信息，请参阅PostgreSQL文档中的显式子事务。

Python模块plpy实现了这些函数来管理错误和消息：

• plpy.debug
• plpy.log
• plpy.info
• plpy.notice
• plpy.warning
• plpy.error
• plpy.fatal
• plpy.debug

消息函数plpy.error和plpy.fatal引发一个Python异常，如果未被捕获，则传播到调用查询，导致当前事务或子事务中止。 函数raise plpy.ERROR(msg)和raise plpy.FATAL(msg)分别与plpy.error和plpy.fatal等价。 其他消息函数仅生成不同优先级的消息。

是否向客户端报告特定优先级的消息，写入服务器日志， 还是两者都由Greenplum数据库服务器配置参数log_min_messages和client_min_messages控制。 有关参数的信息，请参阅Greenplum数据库参考指南。

在性能方面，导入Python模块是一项昂贵的操作，可能会影响性能。 如果要经常导入同一模块，则可以使用Python全局变量在第一次调用时加载模块，而不需要在后续调用中导入模块。 以下PL/Python函数使用GD持久存储字典来避免导入模块（如果模块已经导入并且在GD中）。

psql=#
   CREATE FUNCTION pytest() returns text as $$ 
      if 'mymodule' not in GD:
        import mymodule
        GD['mymodule'] = mymodule
    return GD['mymodule'].sumd([1,2,3])
$$;

Python实用程序pip安装Python包，其中包含Python模块和来自版本化归档文件的其他资源文件。

运行此命令以安装pip。

python -m ensurepip --default-pip

该命令运行ensurepip模块以从本地Python安装引导（安装和配置）pip实用程序。

您可以运行此命令以确保pip，setuptools和wheel项目是最新的。 当前的Python项目确保您可以从源代码分发或预构建的分发（wheels）安装Python包。

python -m pip install --upgrade pip setuptools wheel

$ gpssh -s -f gpdb_hosts
=> python -m ensurepip --default-pip
[centos6-mdw1] Ignoring indexes: https://pypi.python.org/simple
[centos6-mdw1] Collecting setuptools
[centos6-mdw1] Collecting pip
[centos6-mdw1] Installing collected packages: setuptools, pip
[centos6-mdw1] Successfully installed pip-8.1.1 setuptools-20.10.1
[centos6-sdw1] Ignoring indexes: https://pypi.python.org/simple
[centos6-sdw1] Collecting setuptools
[centos6-sdw1] Collecting pip
[centos6-sdw1] Installing collected packages: setuptools, pip
[centos6-sdw1] Successfully installed pip-8.1.1 setuptools-20.10.1
=> exit
$

=>是gpssh的非活动提示。 该实用程序显示每个主机的输出。 exit命令退出gpssh交互模式。

gpssh -s -f gpdb_hosts python -m pip install --upgrade pip setuptools wheel

该实用程序显示每个主机的输出。

有关安装Python包的更多信息，参考https://packaging.python.org/tutorials/installing-packages/。

安装pip后，您可以安装Python包。 此命令安装numpy和scipy包。

python -m pip install --user numpy scipy

--user选项尝试在安装Python包时避免冲突。

您可以使用gpssh在Greenplum数据库主机上运行该命令。

有关这些和其他Python包的信息，请参阅参考。

如果要构建Python模块，则必须确保构建创建正确的可执行文件。 例如，在Linux系统上，构建应该创建一个64位可执行文件。

在构建要安装的Python模块之前，请确保已安装并正确配置构建模块的相应软件。 只有在构建模块的主机上才需要构建环境。

您可以使用Greenplum数据库实用程序gpssh和gpscp在Greenplum数据库主机上运行命令并将文件复制到主机。

您可以创建一个简单的PL/Python用户定义函数（UDF）来验证Python模块在Greenplum数据库中是否可用。 此示例测试NumPy模块。

此PL/Python UDF导入NumPy模块。 如果导入模块成功，则函数返回SUCCESS;如果发生导入错误，则返回FAILURE。

CREATE OR REPLACE FUNCTION plpy_test(x int)
returns text
as $$
  try:
      from numpy import *
      return 'SUCCESS'
  except ImportError, e:
      return 'FAILURE'
$$ language plpythonu;

创建一个包含每个Greenplum数据库segment实例上的数据的表。 根据Greenplum数据库安装的大小，您可能需要生成更多数据以确保将数据分发到所有segment实例。

CREATE TABLE DIST AS (SELECT x FROM generate_series(1,50) x ) DISTRIBUTED RANDOMLY ;

此SELECT命令在segment主机上运行UDF，其中数据存储在primary实例中。

SELECT gp_segment_id, plpy_test(x) AS status
  FROM dist
  GROUP BY gp_segment_id, status
  ORDER BY gp_segment_id, status;

如果UDF在Greenplum数据库segment实例上成功导入Python模块，则SELECT命令返回SUCCESS。 如果SELECT命令返回FAILURE，则可以找到segment实例主机的segment主机。 Greenplum数据库系统表gp_segment_configuration包含有关mirror和segment配置的信息。 此命令返回segment ID的主机名。

SELECT hostname, content AS seg_ID FROM gp_segment_configuration
  WHERE content = seg_id ;

如果返回FAILURE，则可能是以下原因：

• 访问所需库时出现问题。 对于NumPy示例，Greenplum数据库可能在访问OpenBLAS库或segment主机上的Python库时遇到问题。
  在segment主机上以gpadmin用户身份运行命令时，请确保没有错误。 此gpssh命令测试在segment主机mdw1上导入numpy模块。

  gpssh -s -h mdw1 python -c "import numpy"

• 如果Python import命令未返回错误，则可能未在Greenplum数据库环境中配置环境变量。 例如，在主机系统上安装Python包之后，可能尚未重新启动Greenplum数据库。

有关Python语言的信息，参考https://www.python.org/。

有关PL/Python的信息，请参阅PostgreSQL文档https://www.postgresql.org/docs/9.4/plpython.html。

有关Python包索引（PyPI）的信息，参考https://pypi.python.org/pypi。