Skip to main content
Skip to main content

Contribute UDF

Contribute UDF

This manual mainly introduces how external users can contribute their own UDF functions to the Doris community.

Prerequisitesโ€‹

  1. UDF function is universal

    The versatility here mainly refers to: UDF functions are widely used in certain business scenarios. Such UDF functions are valuable and can be used directly by other users in the community.

    If you are not sure whether the UDF function you wrote is universal, you can send an email to dev@doris.apache.org or directly create an ISSUE to initiate the discussion.

  2. UDF has completed testing and is running normally in the user's production environment

Ready to workโ€‹

  1. UDF source code
  2. User Manual of UDF

Source codeโ€‹

Create a folder for UDF functions under contrib/udf/src/, and store the source code and CMAKE files here. The source code to be contributed should include: .h, .cpp, CMakeFile.txt. Taking udf_samples as an example here, first create a new folder under the contrib/udf/src/ path and store the source code.

   โ”œโ”€โ”€contrib
โ”‚ โ””โ”€โ”€ udf
โ”‚ โ”œโ”€โ”€ CMakeLists.txt
โ”‚ โ””โ”€โ”€ src
โ”‚ โ””โ”€โ”€ udf_samples
โ”‚ โ”œโ”€โ”€ CMakeLists.txt
โ”‚ โ”œโ”€โ”€ uda_sample.cpp
โ”‚ โ”œโ”€โ”€ uda_sample.h
โ”‚ โ”œโ”€โ”€ udf_sample.cpp
โ”‚ โ””โ”€โ”€ udf_sample.h

  1. CMakeLists.txt

    After the user's CMakeLists.txt is placed here, a small amount of changes are required. Just remove include udf and udf lib. The reason for the removal is that it has been declared in the CMake file at the contrib/udf level.

manualโ€‹

The user manual needs to include: UDF function definition description, applicable scenarios, function syntax, how to compile UDF, how to use UDF in Doris, and use examples.

  1. The user manual must contain both Chinese and English versions and be stored under docs/zh-CN/extending-doris/contrib/udf and docs/en/extending-doris/contrib/udf respectively.

    โ”œโ”€โ”€ docs
    โ”‚ย ย  โ””โ”€โ”€ zh-CN
    โ”‚ย ย  โ””โ”€โ”€extending-doris
    โ”‚ โ””โ”€โ”€udf
    โ”‚ โ””โ”€โ”€contrib
    โ”‚ โ”œโ”€โ”€ udf-simple-manual.md

    โ”œโ”€โ”€ docs
    โ”‚ย ย  โ””โ”€โ”€ en
    โ”‚ย ย  โ””โ”€โ”€extending-doris
    โ”‚ โ””โ”€โ”€udf
    โ”‚ โ””โ”€โ”€contrib
    โ”‚ โ”œโ”€โ”€ udf-simple-manual.md
  2. Add the two manual files to the sidebar in Chinese and English.

    vi docs/.vuepress/sidebar/zh-CN.js
    {
    title: "็”จๆˆท่ดก็Œฎ็š„ UDF",
    directoryPath: "contrib/",
    children:
    [
    "udf-simple-manual",
    ],
    },
    vi docs/.vuepress/sidebar/en.js
    {
    title: "Users contribute UDF",
    directoryPath: "contrib/",
    children:
    [
    "udf-simple-manual",
    ],
    },

Contribute UDF to the communityโ€‹

When you meet the conditions and prepare the code, you can contribute UDF to the Doris community after the document. Simply submit the request (PR) on Github. See the specific submission method: Pull Request (PR).

Finally, when the PR assessment is passed and merged. Congratulations, your UDF becomes a third-party UDF supported by Doris. You can check it out in the ecological expansion section of Doris official website~.