すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:CreateSqlLogTask

    ドキュメントセンター

    Database Autonomy Service:CreateSqlLogTask

    最終更新日:Mar 13, 2026

    Database Autonomy Service (DAS) Enterprise Edition 用のオフラインタスクを作成します。

    操作説明

    この操作を呼び出す前に、以下の点にご注意ください。

    • Alibaba Cloud SDK または DAS SDK を使用してこの操作を呼び出す場合は、最新バージョンの SDK をご使用いただくことを推奨します。

    • DAS の操作を SDK で呼び出す場合、リージョン ID を cn-shanghai に設定する必要があります。

    • オフラインタスクは、DAS Enterprise Edition V2 または V3 が有効化されたデータベースインスタンスに対してのみ作成できます。各バージョンの DAS Enterprise Edition でサポートされるデータベースおよびリージョンの詳細については、「エディションとサポートされる機能」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    hdm:CreateSqlLogTask

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    任意

    データベースインスタンスの ID。

    pc-2ze8g2am97624****
    NodeId

    string

    任意

    ノード ID。

    説明

    このパラメーターは、クラスタアーキテクチャで実行されているインスタンスでのみ使用可能です。特定のノードのオフラインタスクを照会する場合に指定します。デフォルトでは、このパラメーターを指定しない場合、プライマリノードのオフラインタスクに関する情報が返されます。

    pi-uf6k5f6g3912i****
    Type

    string

    任意

    タスクの種類。有効な値は以下のとおりです。

    • Export

    • Query

    • Insight

    Export
    Name

    string

    任意

    タスクの名前。

    SQL审计导出1

    Filters

    array<object>

    任意

    フィルター条件。

    object

    任意

    Key

    string

    任意

    フィルター パラメーターの名前。

    説明

    サポートされるフィルター パラメーターおよびその有効な値の詳細については、以下の「Key パラメーターの補足情報」をご参照ください。

    KeyWords
    Value

    string

    任意

    フィルター パラメーターの値。

    select
    StartTime

    integer

    任意

    照会対象の時間範囲の開始時刻。UNIX タイムスタンプ形式（ミリ秒単位）で指定します。

    1596177993000

    EndTime

    integer

    任意

    照会対象の時間範囲の終了時刻。UNIX タイムスタンプ形式（ミリ秒単位）で指定します。

    1608888296000

    Role

    string

    任意

    PolarDB-X 2.0 データベースインスタンスのノードのロール。有効な値は以下のとおりです。

    • polarx_cn: コンピュートノード

    • polarx_dn: データノード

    polarx_cn

    以下のリストは、Key として使用可能なフィルター パラメーターおよびその有効な値を示しています。

    • KeyWords: キーワード。スペースで区切って複数のキーワードを指定できます。

    • LogicalOperator: キーワード間の論理演算。有効な値は and および or です。

    • AccountName: ユーザー名。

    • DBName: データベース名。

    • HostAddress: クライアントの IP アドレス。

    • MaxConsume: 最大消費時間（ミリ秒単位）。

    • MinConsume: 最小消費時間（ミリ秒単位）。

    • MaxScanRows: スキャンされる最大行数。

    • MinScanRows: スキャンされる最小行数。

    • SqlType: SQL ステートメントの種類。有効な値は select、update、insert、delete です。

    • State: 実行結果。有効な値は 0 および 1 です。0 は SQL ステートメントの実行が成功したことを示し、1 は失敗したことを示します。

    • ThreadId: スレッド ID。

    • SortKey: ソートに使用する列の名前。有効な値は ScanRows、UpdateRows、Consume、ExecuteTime、ReturnRows、LockTime、Frows、Scnt、CpuTime、PhysicalRead です。ScanRows はスキャンされた行数を示し、UpdateRows は更新された行数を示し、Consume はクエリの実行時間を示し、ExecuteTime はクエリの実行時刻を示し、ReturnRows は返された行数を示し、LockTime はロック待ち時間を示し、Frows は PolarDB-X 2.0 データベースインスタンスのコンピュートノードによってプルされた行数を示し、Scnt は PolarDB-X 2.0 データベースインスタンスのコンピュートノードからデータノードへ送信されたリクエスト数を示し、CpuTime は CPU 実行時間を示し、PhysicalRead は物理読み込み回数を示します。

    • SortMethod: 照会ログのソート順。有効な値は DESC および ASC です。DESC は降順、ASC は昇順を意味します。デフォルト値は DESC です。

    • TraceId: PolarDB-X 2.0 データベースインスタンスのトレース ID。

    • MinRows: 更新される最小行数。

    • MaxRows: 更新される最大行数。

    • MinScnt: PolarDB-X 2.0 データベースインスタンスのコンピュートノードからデータノードへ送信されるリクエストの最小数。

    • MaxScnt: PolarDB-X 2.0 データベースインスタンスのコンピュートノードからデータノードへ送信されるリクエストの最大数。

    • TrxId: トランザクション ID。

    • Fail: エラーコード。

    • sqlId: SQL ステートメント ID。

    • JobId: 非同期タスクの ID。データベースインスタンスで DAS Enterprise Edition V0 または V1 が有効化されている場合、戻り値を照会するにはこのパラメーターを指定する必要があります。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    応答コード。

    200
    Message

    string

    返されたメッセージ。

    説明

    リクエストが成功した場合、「Successful」が返されます。リクエストが失敗した場合、エラーコードなどのエラー情報が返されます。

    Successful
    RequestId

    string

    リクエスト ID。

    83D9D59B-057A-54A9-BFF9-CF2B42F05645
    Success

    string

    リクエストが成功したかどうかを示します。有効な値は以下のとおりです。

    • true

    • false

    true
    Data

    object

    返されたデータ。

    TaskId

    string

    タスク ID。

    54f8041743ca3a9ac5cb9342d050527c
    InstanceId

    string

    データベースインスタンスの ID。

    pc-2ze8g2am97624****
    Name

    string

    タスクの名前。

    Export_test
    Start

    integer

    照会対象の時間範囲の開始時刻。これは、1970 年 1 月 1 日 00:00:00 UTC からの経過ミリ秒数を表す UNIX タイムスタンプです。

    1596177993000
    End

    integer

    照会対象の時間範囲の終了時刻。これは、1970 年 1 月 1 日 00:00:00 UTC からの経過ミリ秒数を表す UNIX タイムスタンプです。

    1608888296000

    Status

    string

    タスクの状態。有効な値は以下のとおりです。

    • INIT: タスクがスケジュール待ちです。

    • RUNNING: タスクが実行中です。

    • FAILED: タスクが失敗しました。

    • CANCELED: タスクがキャンセルされました。

    • COMPLETED: タスクが完了しました。

    説明

    COMPLETED 状態のタスクの結果は表示できます。

    COMPLETED
    CreateTime

    integer

    タスクが作成された時刻。これは UNIX タイムスタンプです（ミリ秒単位）。

    1681363254423

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "83D9D59B-057A-54A9-BFF9-CF2B42F05645",
  "Success": "true",
  "Data": {
    "TaskId": "54f8041743ca3a9ac5cb9342d050527c",
    "InstanceId": "pc-2ze8g2am97624****",
    "Name": "Export_test",
    "Start": 1596177993000,
    "End": 1608888296000,
    "Status": "COMPLETED",
    "CreateTime": 1681363254423
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The request parameters are invalid.
    403 NoPermission You are not authorized to do this action.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。