DataWorks:Doris data source

アカウントの作成と権限の設定

データウェアハウスに接続するには、ログインアカウントを作成し、パスワードを設定する必要があります。デフォルトの root ユーザーでログインする場合、このユーザーには初期パスワードが設定されていないため、パスワードを設定する必要があります。Doris で次の SQL 文を実行してパスワードを設定できます：

SET PASSWORD FOR 'root' = PASSWORD('your_password')

Doris のネットワーク接続の設定

StreamLoad を使用してデータをインポートするには、フロントエンド (FE) ノードのプライベートエンドポイントにアクセスする必要があります。FE ノードのパブリックエンドポイントにアクセスすると、バックエンド (BE) ノードのプライベート IP アドレスにリダイレクトされます (データ操作に関するよくある質問)。したがって、Doris と、使用する サーバーレスリソースグループまたは Data Integration 専用リソースグループとの間にネットワーク接続を確立する必要があります。これにより、プライベートエンドポイント経由でのアクセスが可能になります。ネットワーク接続の確立方法の詳細については、「ネットワーク接続ソリューション」をご参照ください。

コードエディタを使用したバッチ同期タスクの設定

コードエディタを使用してバッチ同期タスクを設定する場合、統一されたスクリプト形式の要件に基づいて、スクリプト内の関連パラメーターを設定する必要があります。詳細については、「コードエディタでのタスクの設定」をご参照ください。以下では、コードエディタを使用してバッチ同期タスクを設定する際に、データソースに対して設定する必要があるパラメーターについて説明します。

Reader スクリプトのデモ

{
  "type": "job",
  "version": "2.0",// バージョン番号。
  "steps": [
    {
      "stepType": "doris",// プラグイン名。
      "parameter": {
        "column": [// 列名。
          "id"
        ],
        "connection": [
          {
            "querySql": [
              "select a,b from join1 c join join2 d on c.id = d.id;"
            ],
            "datasource": ""// データソース名。
          }
        ],
        "where": "",// フィルター条件。
        "splitPk": "",// シャードキー。
        "encoding": "UTF-8"// エンコード形式。
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "stream",
      "parameter": {},
      "name": "Writer",
      "category": "writer"
    }
  ],
  "setting": {
    "errorLimit": {
      "record": "0"// エラーレコード数。
    },
    "speed": {
      "throttle": true,// throttle を false に設定すると、mbps パラメーターは有効にならず、レート制限がないことを示します。throttle を true に設定すると、レート制限が適用されます。
      "concurrent": 1,// 同時実行ジョブ数。
      "mbps": "12"// レート制限。1 mbps は 1 MB/s に相当します。
    }
  },
  "order": {
    "hops": [
      {
        "from": "Reader",
        "to": "Writer"
      }
    ]
  }
}

Reader スクリプトのパラメーター

Writer スクリプトのデモ

{
  "stepType": "doris",// プラグイン名。
  "parameter":
  {
    "postSql":// データ同期タスクの実行後に実行される SQL 文。
    [],
    "preSql":
    [],// データ同期タスクの実行前に実行される SQL 文。
    "datasource":"doris_datasource",// データソース名。
    "table": "doris_table_name",// テーブル名。
    "column":
    [
      "id",
      "table_id",
      "table_no",
      "table_name",
      "table_status"
    ],
    "loadProps":{
      "column_separator": "\\x01",// CSV 形式の列区切り文字。
      "line_delimiter": "\\x02"// CSV 形式の行区切り文字。
    }
  },
  "name": "Writer",
  "category": "writer"
}

Writer スクリプトのパラメーター

"loadProps": {
    "format":"csv",
    "column_separator": "\t",
    "line_delimiter": "\n"
}

"loadProps": {
    "format": "json"
}

集計タイプのスクリプト (Doris Writer による集計タイプへの書き込み)

Doris Writer は、集計タイプのデータの書き込みをサポートしています。ただし、コードエディタで追加の設定を行う必要があります。次の例は、必要な設定を示しています。

たとえば、次の Doris テーブルを考えます。uuid 列は bitmap タイプ (集計タイプ) で、sex 列は HLL タイプ (集計タイプ) です。

CREATE TABLE `example_table_1` (
  `user_id` int(11) NULL,
  `date` varchar(10) NULL DEFAULT "10.5",
  `city` varchar(10) NULL,
  `uuid` bitmap BITMAP_UNION NULL, -- 集計タイプ
  `sex` HLL HLL_UNION  -- 集計タイプ
) ENGINE=OLAP AGGREGATE KEY(`user_id`, `date`,`city`)
COMMENT 'OLAP' DISTRIBUTED BY HASH(`user_id`) BUCKETS 32

テーブルに次の生データを挿入します：

user_id,date,city,uuid,sex
0,T0S4Pb,abc,43,'54'
1,T0S4Pd,fsd,34,'54'
2,T0S4Pb,fa3,53,'64'
4,T0S4Pb,fwe,87,'64'
5,T0S4Pb,gbr,90,'56'
2,iY3GiHkLF,234,100,'54'

Doris Writer を使用して集計タイプのデータを書き込む場合、writer.parameter.column で列を指定し、writer.parameter.loadProps.columns で集計関数を設定する必要があります。たとえば、uuid 列には bitmap_hash 集計関数を、sex 列には hll_hash 集計関数を使用できます。

次のコードはスクリプトの例です：

{
    "stepType": "doris",// プラグイン名。
    "writer":
    {
        "parameter":
        {
            "column":
            [
                "user_id",
                "date",
                "city",
                "uuid",// bitmap 集計タイプ
                "sex"// HLL 集計タイプ
            ],
            "loadProps":
            {
                "format": "csv",
                "column_separator": "\\x01",
                "line_delimiter": "\\x02",
                "columns": "user_id,date,city,k1,uuid=bitmap_hash(k1),k2,sex=hll_hash(k2)"// 集計関数を指定する必要があります。
            },
            "postSql":
            [
                "select count(1) from example_tbl_3"
            ],
            "preSql":
            [],
            "datasource":"doris_datasource",// データソース名。
                    "table": "doris_table_name",// テーブル名。
        }
          "name": "Writer",
              "category": "writer"
    }
}