All Products
Search
Document Center

E-MapReduce:ListDoctorHBaseTables

Last Updated:Dec 12, 2024

Obtains the information about multiple HBase tables at a time.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
emr:ListDoctorHBaseTableslist
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region.

cn-hangzhou
ClusterIdstringYes

The ID of the cluster.

c-b933c5aac8fe****
NextTokenstringNo

Marks the current position to start reading. If this field is empty, the data is read from the beginning.

DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResultsintegerNo

The maximum number of entries that are returned.

20
DateTimestringYes

The query date.

2023-01-01
TableNamesarrayNo

The table names, which are used to filter the query results.

StringstringNo

The table names.

namespace1:tb_item
OrderTypestringNo

The order in which you want to sort the query results. Valid value:

  • ASC: in ascending order
  • DESC: in descending order
ASC
OrderBystringNo

The field that you use to sort the query results.

Valid values:

  • tableSize
tableSize

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

Dataarray<object>

The response parameters.

ListDoctorHBaseTablesDTOobject
TableNamestring

The name of the table.

tb_item
Metricsobject

The metric information.

RegionServerCountobject

The number of region servers that host the table.

Namestring

The name of the metric.

regionServerCount
Valuelong

The value of the metric.

2
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Number of region servers count
RegionCountobject

The number of regions that host the table.

Namestring

The name of the metric.

regionCount
Valuelong

The value of the metric.

3
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Number of regions count
TableSizeobject

The size of the table.

Namestring

The name of the metric.

tableSize
Valuelong

The value of the metric.

678
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the table
StoreFileCountobject

The number of StoreFiles.

Namestring

The name of the metric.

storeFileCount
Valuelong

The value of the metric.

36
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Number of store files
DailyReadRequestobject

The total number of read requests for the table in a day.

Namestring

The name of the metric.

dailyReadRequest
Valuelong

The value of the metric.

1000
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Number of read requests per day
DailyWriteRequestobject

The total number of write requests for the table in a day.

Namestring

The name of the metric.

dailyWriteRequest
Valuelong

The value of the metric.

1000
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Number of write requests per day
RegionBalanceobject

The balancing degree.

Namestring

The name of the metric.

regionBalance
Valuefloat

The value of the metric.

1.0
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

The ability to evenly distribute Regions on different RegionServer nodes
RequestBalanceobject

The request balancing degree.

Namestring

The name of the metric.

requestBalance
Valuefloat

The value of the metric.

0.9
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

The balance of distributing requests
HotDataSizeobject

The size of hot data.

Namestring

The name of the metric.

hotDataSize
Valuelong

The value of the metric.

100
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the hot data size
WarmDataSizeobject

The size of warm data.

Namestring

The name of the metric.

warmDataSize
Valuelong

The value of the metric.

100
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the warm data size
ColdDataSizeobject

The size of cold data.

Namestring

The name of the metric.

coldDataSize
Valuelong

The value of the metric.

100
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the cold data size
FreezeDataSizeobject

The size of very cold data.

Namestring

The name of the metric.

freezeDataSize
Valuelong

The value of the metric.

100
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the freeze data size
WarmConfigDayobject

The number of consecutive days without access to data before the data is considered as cold data.

Namestring

The name of the metric.

warmConfigDay
Valuelong

The value of the metric.

1
Unitstring

The unit of the metric.

day
Descriptionstring

The description of the metric.

Warm config day
ColdConfigDayobject

The number of consecutive days without access to data before the data is considered as very cold data.

Namestring

The name of the metric.

coldConfigDay
Valuelong

The value of the metric.

1
Unitstring

The unit of the metric.

dat
Descriptionstring

The description of the metric.

Cold config day
FreezeConfigDayobject

The number of consecutive days without access to data before the data was considered as very cold data.

Namestring

The name of the metric.

freezeConfigDay
Valuelong

The value of the metric.

1
Unitstring

The unit of the metric.

day
Descriptionstring

The description of the metric.

Freeze config day
Localityobject

The localization rate.

Namestring

The name of the metric.

locality
Valuefloat

The value of the metric.

0
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

The locality of data
ColdAccessDayobject

The number of days during which the table was not accessed.

Namestring

The name of the metric.

coldAccessDay
Valuelong

The value of the metric.

1
Unitstring

The unit of the metric.

day
Descriptionstring

The description of the metric.

Cold access day
RegionCountDayGrowthRatioobject

The daily increment ratio of the number of regions.

Namestring

The name of the metric.

regionCountDayGrowthRatio
Valuefloat

The value of the metric.

1.0
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Day growth ratio of region count
TableSizeDayGrowthRatioobject

The daily increment ratio of the table size.

Namestring

The name of the metric.

tableSizeDayGrowthRatio
Valuefloat

The value of the metric.

1.0
Unitstring

The unit of the metric.

'"
Descriptionstring

The description of the metric.

Day growth ratio of table size
StoreFileCountDayGrowthRatioobject

The daily increment ratio of the number of StoreFiles.

Namestring

The name of the metric.

storeFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.7
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Day growth ratio of store file count
DailyReadRequestDayGrowthRatioobject

The daily increment ratio of the number of read requests in a day.

Namestring

The name of the metric.

dailyReadRequestDayGrowthRatio
Valuefloat

The value of the metric.

0.8
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Day growth ratio of read requests
DailyWriteRequestDayGrowthRatioobject

The daily increment ratio of the number of write requests in a day.

Namestring

The name of the metric.

dailyWriteRequestDayGrowthRatio
Valuefloat

The value of the metric.

0.8
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

The balance of distributing requests
ReadRequestBalanceobject

The read balancing degree.

Namestring

The name of the metric.

readRequestBalance
Valuefloat

The value of the metric.

1.0
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

The balance of distributing read requests
WriteRequestBalanceobject

The write balancing degree.

Namestring

The name of the metric.

writeRequestBalance
Valuefloat

The value of the metric.

1.0
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

The balance of distributing write requests
Analysisobject

The diagnosis result.

TableScoreinteger

The score of the table.

67
RequestUnbalanceSuggestionstring

The description of read/write imbalance.

read request unbalance is <p class='report-detail-topic'>
RequestHotspotRegionListarray

The regions that have read/write hotspot issues.

Stringstring

The region that has read/write hotspot issues.

5f019e8cf7c16be9768634cb99ccbe05
ReadRequestUnbalanceSuggestionstring

The description of read imbalance.

read request unbalance is <p class='report-detail-topic'>
ReadRequestHotspotRegionListarray

The regions that have read hotspot issues.

Stringstring

The region that has read hotspot issues.

5f019e8cf7c16be9768634cb99ccbe05
WriteRequestUnbalanceSuggestionstring

The description of write imbalance.

write request unbalance is <p class='report-detail-topic'>
WriteRequestHotspotRegionListarray

The regions that have write hotspot issues.

Stringstring

The region that has write hotspot issues.

5f019e8cf7c16be9768634cb99ccbe05
RequestIdstring

The ID of the request.

DD6B1B2A-5837-5237-ABE4-FF0C8944****
NextTokenstring

The page number of the next page returned.

DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResultsinteger

The maximum number of entries returned.

20
TotalCountinteger

The total number of entries returned.

200

Examples

Sample success responses

JSONformat

{
  "Data": [
    {
      "TableName": "tb_item",
      "Metrics": {
        "RegionServerCount": {
          "Name": "regionServerCount",
          "Value": 2,
          "Unit": "\"\"",
          "Description": "Number of region servers count"
        },
        "RegionCount": {
          "Name": "regionCount",
          "Value": 3,
          "Unit": "\"\"",
          "Description": "Number of regions count"
        },
        "TableSize": {
          "Name": "tableSize",
          "Value": 678,
          "Unit": "MB",
          "Description": "Size of the table"
        },
        "StoreFileCount": {
          "Name": "storeFileCount",
          "Value": 36,
          "Unit": "\"\"",
          "Description": "Number of store files"
        },
        "DailyReadRequest": {
          "Name": "dailyReadRequest",
          "Value": 1000,
          "Unit": "“”",
          "Description": "Number of read requests per day"
        },
        "DailyWriteRequest": {
          "Name": "dailyWriteRequest",
          "Value": 1000,
          "Unit": "“”",
          "Description": "Number of write requests per day"
        },
        "RegionBalance": {
          "Name": "regionBalance",
          "Value": 1,
          "Unit": "“”",
          "Description": "The ability to evenly distribute Regions on different RegionServer nodes"
        },
        "RequestBalance": {
          "Name": "requestBalance",
          "Value": 0.9,
          "Unit": "“”",
          "Description": "The balance of distributing requests"
        },
        "HotDataSize": {
          "Name": "hotDataSize",
          "Value": 100,
          "Unit": "MB",
          "Description": "Size of the hot data size"
        },
        "WarmDataSize": {
          "Name": "warmDataSize",
          "Value": 100,
          "Unit": "MB",
          "Description": "Size of the warm data size"
        },
        "ColdDataSize": {
          "Name": "coldDataSize",
          "Value": 100,
          "Unit": "MB",
          "Description": "Size of the cold data size"
        },
        "FreezeDataSize": {
          "Name": "freezeDataSize",
          "Value": 100,
          "Unit": "MB",
          "Description": "Size of the freeze data size"
        },
        "WarmConfigDay": {
          "Name": "warmConfigDay",
          "Value": 1,
          "Unit": "day",
          "Description": "Warm config day"
        },
        "ColdConfigDay": {
          "Name": "coldConfigDay",
          "Value": 1,
          "Unit": "dat",
          "Description": "Cold config day"
        },
        "FreezeConfigDay": {
          "Name": "freezeConfigDay",
          "Value": 1,
          "Unit": "day",
          "Description": "Freeze config day"
        },
        "Locality": {
          "Name": "locality",
          "Value": 0,
          "Unit": "\"\"",
          "Description": "The locality of data"
        },
        "ColdAccessDay": {
          "Name": "coldAccessDay",
          "Value": 1,
          "Unit": "day",
          "Description": "Cold access day"
        },
        "RegionCountDayGrowthRatio": {
          "Name": "regionCountDayGrowthRatio",
          "Value": 1,
          "Unit": "\"\"",
          "Description": "Day growth ratio of region count"
        },
        "TableSizeDayGrowthRatio": {
          "Name": "tableSizeDayGrowthRatio",
          "Value": 1,
          "Unit": "'\"",
          "Description": "Day growth ratio of table size"
        },
        "StoreFileCountDayGrowthRatio": {
          "Name": "storeFileCountDayGrowthRatio",
          "Value": 0.7,
          "Unit": "\"\"",
          "Description": "Day growth ratio of store file count"
        },
        "DailyReadRequestDayGrowthRatio": {
          "Name": "dailyReadRequestDayGrowthRatio",
          "Value": 0.8,
          "Unit": "\"\"",
          "Description": "Day growth ratio of read requests"
        },
        "DailyWriteRequestDayGrowthRatio": {
          "Name": "dailyWriteRequestDayGrowthRatio",
          "Value": 0.8,
          "Unit": "\"\"",
          "Description": "The balance of distributing requests"
        },
        "ReadRequestBalance": {
          "Name": "readRequestBalance",
          "Value": 1,
          "Unit": "\"\"",
          "Description": "The balance of distributing read requests"
        },
        "WriteRequestBalance": {
          "Name": "writeRequestBalance",
          "Value": 1,
          "Unit": "\"\"",
          "Description": "The balance of distributing write requests"
        }
      },
      "Analysis": {
        "TableScore": 67,
        "RequestUnbalanceSuggestion": "read request unbalance is <p class='report-detail-topic'>",
        "RequestHotspotRegionList": [
          "5f019e8cf7c16be9768634cb99ccbe05"
        ],
        "ReadRequestUnbalanceSuggestion": "read request unbalance is <p class='report-detail-topic'>",
        "ReadRequestHotspotRegionList": [
          "5f019e8cf7c16be9768634cb99ccbe05"
        ],
        "WriteRequestUnbalanceSuggestion": "write request unbalance is <p class='report-detail-topic'>",
        "WriteRequestHotspotRegionList": [
          "5f019e8cf7c16be9768634cb99ccbe05"
        ]
      }
    }
  ],
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
  "MaxResults": 20,
  "TotalCount": 200
}

Error codes

HTTP status codeError codeError message
400ConflictParametersParameters that must not be used together. %s
400IncompleteSignatureThe request signature is invalid.
400InvalidActionThe action %s requested is invalid.
400InvalidParameterThe specified parameter %s is not valid.
400InvalidParameterValueThe input parameter %s is invalid or out of range.
400MissingActionThe action %s requested is missing.
400MissingParameterThe input parameter %s that is mandatory for processing this request is not supplied.
400NotAuthorizedYou do not have permission to perform this action. %s
400ThrottlingExceptionThe request was denied due to request throttling. %s
404ResourceNotFoundThe resource not found by %s.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.
503ServiceFailureThe request has failed due to a temporary failure of %s service.
503ServiceUnavailableThe request has failed due to a temporary failure of the server.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history