すべてのプロダクト
Search

このプロダクト

    :DescribeTableAccessCount

    ドキュメントセンター

    :DescribeTableAccessCount

    最終更新日:Jan 14, 2026

    指定された日付における、AnalyticDB for MySQL クラスター内の特定のテーブルまたはすべてのテーブルのアクセス数をクエリします。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    adb:DescribeTableAccessCount

    get

    DBCluster

    acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DBClusterId

    string

    必須

    クラスター ID。

    説明

    DescribeDBClusters 操作を呼び出して、特定のリージョン内のすべての AnalyticDB for MySQL クラスターの詳細 (クラスター ID を含む) をクエリできます。

    am-bp1r053byu48p****
    TableName

    string

    任意

    対象テーブルの名前。

    説明

    このパラメーターを空のままにした場合、指定された日付におけるクラスター内のすべてのテーブルのアクセス頻度に関するデータが返されます。

    CUSTOMER
    StartTime

    string

    必須

    クエリする日付。yyyy-MM-dd 形式を使用します。時刻は UTC です。

    説明

    過去 30 日間のデータのみをクエリできます。

    2021-08-30
    Order

    string

    任意

    クエリ結果のソート順。値は JSON 文字列です。例：[{"Field":"TableSchema","Type":"Asc"}]。JSON 文字列には次のフィールドが含まれます：

    • Field：ソートに使用するフィールド。有効な値：

      • TableSchema：データベースの名前。

      • TableName：テーブルの名前。

      • AccessCount：テーブルがアクセスされた回数。

    • Type：ソートのタイプ。有効な値：

      • Asc：昇順。

      • Desc：降順。

    説明

    このパラメーターを指定しない場合、結果はデータベース名で昇順にソートされます。

    [{"Field":"TableSchema","Type":"Asc"}]
    PageNumber

    integer

    任意

    ページ番号。0 より大きい整数である必要があります。デフォルト値：1。

    1
    PageSize

    integer

    任意

    各ページに返すエントリ数。正の整数である必要があります。デフォルト値：30。

    30
    RegionId

    string

    必須

    リージョン ID。

    説明

    DescribeRegions 操作を呼び出して、AnalyticDB for MySQL の利用可能なリージョンとゾーン (リージョン ID を含む) をクエリできます。

    cn-hangzhou

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    詳細。

    RequestId

    string

    リクエスト ID。

    C242707A-01D1-54DA-A5F6-671557******
    PageNumber

    integer

    ページ番号。

    1
    PageSize

    integer

    現在のページのエントリ数。

    30
    TotalCount

    integer

    エントリの総数。

    1
    Items

    array<object>

    テーブルの使用状況の詳細。

    object

    詳細。

    ReportDate

    string

    テーブルの使用日。

    2021-08-30
    TableSchema

    string

    テーブルが属するデータベース。

    tpch
    AccessCount

    string

    テーブルがアクセスされた回数。

    6
    TableName

    string

    テーブル名。

    CUSTOMER
    InstanceName

    string

    テーブルが属するクラスターの ID。

    am-bp1r053byu48p****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "C242707A-01D1-54DA-A5F6-671557******",
  "PageNumber": 1,
  "PageSize": 30,
  "TotalCount": 1,
  "Items": [
    {
      "ReportDate": "2021-08-30",
      "TableSchema": "tpch",
      "AccessCount": "6",
      "TableName": "CUSTOMER",
      "InstanceName": "am-bp1r053byu48p****"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    503 ServiceUnavailable An error occurred while processing your request. An error occurred while processing your request.

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

    変更履歴

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