使用Python的Mock库进行PySpark单元测试

测试是软件开发中的基础，它经常被数据开发者忽视，但是它很重要。在本文中会展示如何使用python的uniittest.mock库，对一段pyspark代码进行测试。笔者会从数据科学家的视角来进行工作，这意味着本文将不会深入某些软件开发的细节。

本文链接：https://www.cnblogs.com/hhelibeb/p/10508692.html

英文原文：stop mocking me! unit tests in pyspark using python’s mock library

单元测试和mock是什么？

单元测试是一种测试代码片段的方式，确保代码片段按预期工作。python中的uniittest.mock库，允许人们将部分代码替换为mock对象，并对人们使用这些mock对象的方式进行断言。“mock”的功能如名字所示——它模仿代码中的对象/变量的属性。

最终目标：测试spark.sql(query)

pyspark中最简单的创建dataframe的方式如下：

df = spark.sql("select * from table")

虽然它很简单，但依然应该被测试。

准备代码和问题

假设我们为一家电子商务服装公司服务，我们的目标是创建产品相似度表，用某些条件过滤数据，把它们写入到hdfs中。

假设我们有如下的表：

1. products. columns: “item_id”, “category_id”.

2. product_similarity (unfiltered). columns: “item_id_1”, “item_id_2”, “similarity_score”.

（假设product_similarity中的相似度分数在0~1之间，越接近1，就越相似。）

查看一对产品和他们的分数是很简单的：

select
s.item_id_1,
s.item_id_2,
s.similarity_score
from product_similarity s
where s.item_id_1 != s.item_id_2

where子句将和自身对比的项目移除。否则的话会得到分数为1的结果，没有意义！

要是我们想要创建一个展示相同目录下的产品的相似度的表呢？要是我们不关心鞋子和围巾的相似度，但是想要比较不同的鞋子与鞋子、围巾与围巾呢？这会有点复杂，需要我们连接“product”和“product_similarity”两个表。

查询语句变为：

select
  s.item_id_1,
  s.item_id_2,
  s.similarity_score
from product_similarity s
inner join products p
on s.item_id_1 = p.item_id
inner join products q
on s.item_id_2 = q.item_id
where s.item_id_1 != s.item_id_2
and p.category_id = q.category_i

我们也可能想得知与每个产品最相似的n个其它项目，在该情况下，查询语句为：

select
    s.item_id_1,
    s.item_id_2,
    s.similarity_score
from (
    select
        s.item_id_1,
        s.item_id_2,
        s.similarity_score,
        row_number() over(partition by item_id_1 order by similarity_score desc) as row_num
    from product_similarity s
    inner join products p
    on s.item_id_1 = p.item_id
    inner join products q
    on s.item_id_2 = q.item_id
    where s.item_id_1 != s.item_id_2
    and p.category_id = q.category_id
)
where row_num <= 10

（假设n=10）

现在，要是我们希望跨产品目录比较和在产品目录内比较两种功能成为一个可选项呢？我们可以通过使用名为same_category的布尔变量，它会控制一个字符串变量same_category_q的值，并将其传入查询语句（通过.format()）。如果same_category为true，则same_category_q中为inner join的内容，反之，则为空。查询语句如下：

'''
select
  s.item_id_1,
  s.item_id_2,
  s.similarity_score
from product_similarity s
{same_category_q}
'''.format(same_category_q='') # depends on value of same_category boolean

（译注：python 3.6以上可以使用f-strings代替format）

让我们把它写得更清楚点，用function包装一下，

def make_query(same_category, table_paths): 

    if same_category is true:
        same_category_q = '''
inner join {product_table} p
on s.item_id_1 = p.item_id
inner join {product_table} q
on s.item_id_2 = q.item_id
where item_id_1 != item_id_2
and p.category_id = q.category_id
'''.format(product_table=table_paths["products"]["table"])
    else:
        same_category_q = ''

return same_category_q

到目前为止，很不错。我们输出了same_category_q，因此可以通过测试来确保它确实返回了所需的值。

回忆我们的目标，我们需要将dataframe写入hdfs，我们可以通过如下方法来测试函数：

def create_new_table(spark, table_paths, params, same_category_q):

    similarity_table = table_paths["product_similarity"]["table"]

    created_table = spark.sql(create_table_query.format(similarity_table=similarity_table,
                                                        same_category_q=same_category_q,
                                                        num_items=params["num_items"]))

    # write table to some path
    created_table.coalesce(1).write.save(table_paths["created_table"]["path"],
format="orc", mode="overwrite")

添加查询的第一部分和一个主方法，完成我们的脚本，得到：

import pyspark
from pyspark.sql import sparksession

create_table_query = '''
select
    item_id_1,
    item_id_2
from (
    select
        item_id_1,
        item_id_2,
        row_number() over(partition by item_id_1 order by similarity_score desc) as row_num
    from {similarity_table} s
    {same_category_q}
    )
where row_num <= {num_items}
'''

def create_new_table(spark, table_paths, params, from_date, to_date, same_category_q):

    similarity_table = table_paths["product_similarity"]["table"]

    created_table = spark.sql(create_table_query.format(similarity_table=similarity_table,
                                                        same_category_q=same_category_q,
                                                        num_items=params["num_items"]))

    # write table to some path
    created_table.coalesce(1).write.save(table_paths["created_table"]["path"],
                                          format="orc", mode="overwrite")


def make_query(same_category, table_paths): 

    if same_category is true:
        same_category_q = '''
inner join {product_table} p
on s.item_id_1 = p.item_id
inner join {product_table} q
on s.item_id_2 = q.item_id
where item_id_1 != item_id_2
and p.category_id = q.category_id
'''.format(product_table=table_paths["product_table"]["table"])
    else:
        same_category_q = ''

    return same_category_q
  
if __name__ == "__main__":
   
    spark = (sparksession
             .builder
             .appname("testing_tutorial")
             .enablehivesupport()
             .getorcreate())

    same_category = true # or false
    table_paths = foo # assume paths are in some json 
    params = bar
    
    same_category_q, target_join_q = make_query(same_category, table_paths)
    create_new_table(spark, table_paths, params, same_category_q)

这里的想法是，我们需要创建为脚本中的每个函数创建function，名字一般是test_name_of_function()。需要通过断言来验证function的行为符合预期。

测试查询-make_query

首先，测试make_query。make_query有两个输入参数：一个布尔变量和某些表路径。它会基于布尔变量same_category返回不同的same_category_q。我们做的事情有点像是一个if-then语句集：

1. if same_category is true, then same_category_q = “inner join …”

2. if same_category is false, then same_category_q = “” (empty)

我们要做的是模拟make_query的参数，把它们传递给function，接下来测试是否得到期望的输出。因为test_paths是个目录，我们无需模拟它。测试脚本如下，说明见注释：

def test_make_query_true(mocker):

    # create some fake table paths
    test_paths = {
        "product_table": {
            "table": "products",
        },
        "similarity_table": {
            "table": "product_similarity"
        }
    }

    # call the function with our paths and "true"
    same_category_q = make_query(true, test_paths)
    # we want same_category_q to be non-empty
    assert same_category_q != ''

def test_make_query_false(mocker):

    # as above, create some fake paths
    test_paths = {
        "product_table": {
            "table": "products",
        },
        "similarity_table": {
            "table": "product_similarity"
        }
    }

    same_category_q = make_query(false, test_paths)
    # this time, we want same_category_q to be empty
assert same_category_q == ''

就是这么简单！

测试表创建

下一步，我们需要测试create_new_table的行为。逐步观察function，我们可以看到它做了几件事，有几个地方可以进行断言和模拟。注意，无论何时，只要程序中有某些类似df.write.save.something.anotherthing的内容，我们就需要模拟每个操作和它们的输出。

1. 这个function使用spark作为参数，这需要被模拟。
2. 通过调用spark.sql(create_table_query.format(**some_args))来创建created_table。我们需要断言spark.sql()只被调用了一次。我们也需要模拟spark.sql()的输出。
3. coalesce created_table。保证调用coalesce()时的参数是1。模拟输出。
4. 写coalesced table，我们需要模拟.write，模拟调用它的输出。
5. 将coalesced table保存到一个路径。确保它的调用带有正确的参数。

和前面一样，测试脚本如下：

ef test_create_new_table(mocker):

    # mock all our variables
    mock_spark = mock.mock()
    mock_category_q = mock.mock()
    mock_created_table = mock.mock()
    mock_created_table_coalesced = mock.mock()
    # calling spark.sql with create_table_query returns created_table - we need to mock it
    mock_spark.sql.side_effect = [mock_created_table]
    # mock the output of calling .coalesce on created_table
    mock_created_table.coalesce.return_value = mock_created_table_coalesced
    # mock the .write as well
    mock_write = mock.mock()
    # mock the output of calling .write on the coalesced created table
    mock_created_table_coalesced.write = mock_write

    test_paths = {
        "product_table": {
            "table": "products",
        },
        "similarity_table": {
            "table": "product_similarity"
        },
        "created_table": {
          "path": "path_to_table",
        }
    }
    test_params = {
        "num_items": 10,
    }

    # call our function with our mocks
    create_new_table(mock_spark, test_paths, test_params, mock_category_q)
    # we only want spark.sql to have been called once, so assert that
    assert 1 == mock_spark.sql.call_count
    # assert that we did in fact call created_table.coalesce(1)
    mock_created_table.coalesce.assert_called_with(1)
    # assert that the table save path was passed in properly
    mock_write.save.assert_called_with(test_paths["created_table"]["path"],
format="orc", mode="overwrite")

最后，把每样东西保存在一个文件夹中，如果你想的话，你需要从相应的模块中导入function，或者把所有东西放在同一个脚本中。

为了测试它，在命令行导航到你的文件夹（cd xxx），然后执行：

python -m pytest final_test.py.

你可以看到类似下面的输出，

serena@comp-205:~/workspace$ python -m pytest testing_tutorial.py
============================= test session starts ==============================
platform linux -- python 3.6.4, pytest-3.3.2, py-1.5.2, pluggy-0.6.0
rootdir: /home/serena/workspace/personal,
inifile: plugins: mock-1.10.0 collected 3 items testing_tutorial.py ...
[100%]
=========================== 3 passed in 0.01 seconds ===========================

结语

以上是全部内容。希望你觉得有所帮助。当我试图弄明白如何mock的时候，我希望可以遇到类似这样一篇文章。

现在就去做吧，就像stewie所说的那样，(don’t) stop mocking me (functions)!