Comandos de diagnóstico

buildInfo

Para o comando buildInfo , a resposta contém os seguintes campos:

{
  "ok" : <return>,
  "version" : "<version-number>",
  "versionArray" : [
    <number>,
    <number>,
    <number>,
    <number>
  ],
  "dataLake" : {
    "version" : "<version-number>",
    "gitVersion" : "<version-number>",
    "date" : "<timestamp>",
    "mongoSQLVersion" : "<version-number>"
  }
}

collStats

Para o comando collStats , o Atlas Data Federation omite os seguintes campos na resposta:

• avgObjSize

• capped

• max

• maxSize

• wiredTiger

• nindexes

• totalIndexSize

• indexSizes

O Atlas Data Federation inclui os seguintes campos na resposta. Você pode usar esses campo para verificar quais partições são usadas para preencher uma collection, entender há quanto tempo as estatísticas foram calculadas e determinar se o Atlas Data Federation truncaram o documento de saída.

<major-version-number>.<minor-version-number>.<patch-version-number>

{
  ...
  "partitionCount": <number of partitions>,
  "avgPartitionSize": <average size of all partitions>,
  "partitions": [
    {
        "format": <file format>,
        "attributes": <filtering attributes>,
        "count": <number of documents in partition>,
        "source": <cloud storage URL>,
        "size": <size, in bytes, of the partition>
      },
    ...
  ],
  "truncated": false,
  "cacheMetadata": {
    computeTime: ISODate("2021-07-25T15:10:33.513Z"),
    automaticRefreshInProgress: false
  },
  ...
}

Atlas Data Federation introduz um parâmetro booleano opcional, sync, para ignorar o cache e buscar as estatísticas de armazenamento mais recentes para uma determinada collection. The following values are valid for the sync parameter:

• true - para ignorar o cache e retornar as estatísticas de armazenamento mais recentes

• false - para retornar dados em cache

Se o parâmetro sync for omitido, o padrão será false .

db.runCommand( {collStats: "<string>", sync: true|false} )

Para saber mais sobre os parâmetros suportados por este comando, consulte collStats.

connectionStatus

Para o comando connectionStatus , o Atlas Data Federation retorna informações sobre a conexão atual, especificamente o estado dos usuários autenticados e suas funções disponíveis.

dbStats

Para o comando dbStats , o Atlas Data Federation introduz um parâmetro booleano opcional, sync, para ignorar o cache e buscar as estatísticas de armazenamento mais recentes para um determinado banco de dados de dados. Os seguintes valores são válidos para o parâmetro sync :

• true - para ignorar o cache e retornar as estatísticas de armazenamento mais recentes

• false - para usar também os dados em cache

Se o parâmetro sync for omitido, o padrão será false .

db.runCommand( {dbStats: 1, sync: true|false} )

Para saber mais sobre os parâmetros suportados por este comando, consulte dbStats.

O comando do Atlas Data Federation emite os seguintes campos na resposta:

• object

• avgObjSize

• fsUsedSize

• fsTotalSize

Os comandos adicionam os seguintes campos na resposta. Você pode utilizar estes campos para determinar se o comando retornou dados obsoletos.

explain

O comando explain retorna informações que descrevem o plano de query da Data Federation . A saída explain difere do MongoDB porque fornece informações sobre as partições de dados usadas para satisfazer a query.

Os seguintes comandos podem ser explicados no Data Federation:

• aggregate()

• count()

• find()

db.runCommand({ "explain": { "aggregate": "user", "verbosity":
"queryPlannerExtended", "pipeline": [ ], "cursor": {} }})

db.users.explain("executionStats").find({"type": "admin"})

1
{
2
  ok: 1,
3
  stats: { size: '66 B', numberOfPartitions: 2 },
4
  truncated: false,
5
  plan: {
6
    kind: 'region',
7
    region: 'aws/us-east-1',
8
    node: {
9
      kind: 'data',
10
      size: '66 B',
11
      numberOfPartitions: 2,
12
      partitionsTruncated: false,
13
      partitions: [
14
        {
15
          source: 'projectID:cluster',
16
          provider: 'atlas',
17
          size: '4 B',
18
          database: 'locations',
19
          collection: 'nyc'
20
        },
21
        {
22
          source: 'dls:projectID',
23
          provider: 'dls:aws',
24
          size: '62 B',
25
          metadataLocation: { provider: 'aws', region: 'us-east-1' },
26
          dataSetName: 'v1$atlas$archive$etc',
27
          optimizationPlan: { kind: 'everything' }
28
        }
29
      ]
30
    }
31
  }
32
}

1
{
2
  ok: 1,
3
  stats: { size: '66 B', numberOfPartitions: 2 },
4
  truncated: false,
5
  plan: {
6
    kind: 'region',
7
    region: 'aws/us-east-1',
8
    node: {
9
      kind: 'data',
10
      size: '66 B',
11
      numberOfPartitions: 2,
12
      partitionsTruncated: false,
13
      partitions: [
14
        {
15
          source:'projectID:cluster',
16
          provider: 'atlas',
17
          size: '4 B',
18
          database: 'locations',
19
          collection: 'nyc'
20
        },
21
        {
22
          source: 'dls:projectID',
23
          provider: 'dls:aws',
24
          size: '62 B',
25
          metadataLocation: { provider: 'aws', region: 'us-east-1' },
26
          dataSetName: 'v1$atlas$archive$etc',
27
          scannedDataSetPartitionsCount: 1,
28
          percentOfTotalPartitions: 100,
29
          optimizationPlan: { kind: 'everything' }
30
        },
31
      ]
32
    }
33
  }
34
}

1
{
2
  ok: 1,
3
  stats: { size: '66 B', numberOfPartitions: 2 },
4
  truncated: false,
5
  plan: {
6
    kind: 'region',
7
    region: 'aws/us-east-1',
8
    node: {
9
      kind: 'data',
10
      size: '66 B',
11
      numberOfPartitions: 2,
12
      partitionsTruncated: false,
13
      partitions: [
14
        {
15
          source: 'projectID:cluster',
16
          provider: 'atlas',
17
          size: '4 B',
18
          database: 'locations',
19
          collection: 'nyc',
20
          explainResults: {
21
            queryPlanner: {
22
              ...
23
              winningPlan: {
24
                ...
25
              },
26
              rejectedPlans: []
27
            },
28
            executionStats: {
29
              ...
30
            },
31
            stages: {
32
                ...
33
            }
34
          }
35
        },
36
        {
37
          source: 'dls:projectID',
38
          provider: 'dls:aws',
39
          size: '62 B',
40
          metadataLocation: { provider: 'aws', region: 'us-east-1' },
41
          dataSetName: 'v1$atlas$archive$etc'
42
        },
43
      ]
44
    }
45
  }
46
}

getLog

Para o comando getLog , o Atlas Data Federation retorna uma resposta bem-sucedida, mas não inclui dados de registro.

getMore

Para o comando getMore , o Atlas Data Federation retorna lotes subsequentes de documentos apontados por um cursor, quando usado em conjunto com comandos que retornam um cursor, por exemplo encontrar e agregar.

hostInfo

Para o comando hostInfo , o Atlas Data Federation retorna somente o seguinte subconjunto de campos da resposta padrão do MongoDB :

{
  "ok" : <return>,
  "system" : {
    "currentTime" : ISODate("<timestamp>"),
    "hostname" : "<hostname>",
    "cpuAddrSize" : <number>,
    "memSizeMB" : <number>,
    "numCores" : <number>,
    "cpuArch" : "<identifier>",
  },
  "os" : {
    "type" : "<string>",
    "name" : "<string>",
  },
  "extra" : { }
}

ping

Para o comando ping , o Atlas Data Federation testa se um servidor está respondendo aos comandos.

whatsmyuri

Para o comando whatsmyuri , o Atlas Data Federation retorna o endereço IP do cliente .