Tencent Cloud DLC SDK for Python

3.1.87 verified Sat May 09 auth: no python

Official Tencent Cloud SDK for Data Lake Compute (DLC) service. Provides APIs to manage DLC resources like tasks, databases, tables, and queries. Current version: 3.1.87. Follows Tencent Cloud SDK release cycle with frequent minor updates.

pip install tencentcloud-sdk-python-dlc

Common errors

error AttributeError: module 'tencentcloud.dlc' has no attribute 'v20210125' ↓

cause Subpackage not installed or import path incorrect. The SDK's main package 'tencentcloud-sdk-python-dlc' must be installed separately.

fix

Run 'pip install tencentcloud-sdk-python-dlc' to install the DLC-specific module.

error tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: [TencentCloudSDKException] code: UnauthorizedOperation message: ... ↓

cause Invalid or missing SecretId/SecretKey, or insufficient permissions for DLC API.

fix

Verify credentials via environment variables or Credential constructor. Ensure the account has DLC access.

error ImportError: cannot import name 'DlcClient' from 'tencentcloud.dlc.v20210125.dlc_client' ↓

cause Incorrect import path. The correct path is 'from tencentcloud.dlc.v20210125 import dlc_client'.

fix

Use 'from tencentcloud.dlc.v20210125 import dlc_client' and then 'client = dlc_client.DlcClient(...)'. Do not import DlcClient directly.

Warnings

gotcha The SDK uses a versioned module path. Always use 'tencentcloud.dlc.v20210125' — not 'tencentcloud.dlc' directly. ↓

fix Use 'from tencentcloud.dlc.v20210125 import dlc_client'

deprecated Older authentication patterns using Credential Token (secretKey) without environment or STS are discouraged. Use environment variables or assume role. ↓

fix Set TENCENTCLOUD_SECRET_ID and TENCENTCLOUD_SECRET_KEY environment variables, or use STS temporary credentials.

gotcha Region parameter is required for DLC client. 'ap-guangzhou' is a common default, but ensure you use the correct region for your DLC resources. ↓

fix Pass a valid region string (e.g., 'ap-guangzhou', 'ap-beijing') when constructing DlcClient.

Imports

DlcClient

wrong

from tencentcloud.dlc import DlcClient

correct

from tencentcloud.dlc.v20210125 import dlc_client

Versioned module path is required; top-level DlcClient does not exist

Quickstart

Initializes client and fetches list of Data Lake Compute tasks

import os
from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.dlc.v20210125 import dlc_client, models

try:
    cred = credential.Credential(
        secret_id=os.environ.get('TENCENTCLOUD_SECRET_ID', ''),
        secret_key=os.environ.get('TENCENTCLOUD_SECRET_KEY', '')
    )
    client = dlc_client.DlcClient(cred, "ap-guangzhou")
    req = models.DescribeTasksRequest()
    resp = client.DescribeTasks(req)
    print(resp.to_json_string())
except TencentCloudSDKException as e:
    print(e)