Comandos de diagnóstico

buildInfo

Para el ComandobuildInfo, la respuesta contiene los siguientes 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 el comando collStats, Atlas Data Federation omite los siguientes campos en la respuesta:

• avgObjSize

• capped

• max

• maxSize

• wiredTiger

• nindexes

• totalIndexSize

• indexSizes

Atlas Data Federation incluye los siguientes campos en la respuesta. Puedes usar estos campos para verificar qué particiones se utilizan para poblar una colección, comprender cuán recientemente se calcularon las estadísticas y determinar si Atlas Data Federation truncó el documento de salida.

<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 introduce un parámetro booleano opcional, sync, para omitir la caché y obtener las estadísticas de almacenamiento más recientes de una colección dada. Los siguientes valores son válidos para el parámetro sync:

• true - para omitir el caché y devolver las estadísticas de almacenamiento más recientes

• false - para devolver datos almacenados en caché

Si se omite el parámetro sync, el valor predeterminado es false.

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

Para obtener más información sobre los parámetros que admite este comando, consulte collStats.

connectionStatus

Para el comando connectionStatus, Atlas Data Federation devuelve información sobre la conexión actual, específicamente el estado de los usuarios autenticados y sus rolesdisponibles.

dbStats

Para el comando dbStats, Atlas Data Federation introduce un parámetro booleano opcional, sync, para omitir la caché y obtener las estadísticas de almacenamiento más recientes de una base de datos específica. Los siguientes valores son válidos para el parámetro sync:

• true - para omitir el caché y devolver las estadísticas de almacenamiento más recientes

• false - para utilizar también los datos almacenados en caché

Si se omite el parámetro sync, el valor predeterminado es false.

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

Para aprender más sobre los parámetros compatibles con esta orden, consulte dbStats.

El comando "Atlas Data Federation" omite los siguientes campos en la respuesta:

• object

• avgObjSize

• fsUsedSize

• fsTotalSize

El comando añade los siguientes campos en la respuesta. Puedes utilizar estos campos para determinar si el comando devolvió datos desactualizados.

explain

El comando explain devuelve información que describe el plan del query de Data Federation. La salida de explain difiere de MongoDB en que proporciona información sobre las particiones de datos utilizadas para satisfacer la query.

Los siguientes comandos se pueden explicar en 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 el comando getLog, Atlas Data Federation devuelve una respuesta exitosa, pero no incluye datos del registro.

getMore

Para el comando getMore, Atlas Data Federation devuelve lotes subsecuentes de documentos actualmente apuntados por un cursor, cuando se utiliza junto con comandos que devuelven un cursor, por ejemplo, find y aggregate.

hostInfo

Para el comando hostInfo, Atlas Data Federation devuelve solo el siguiente subconjunto de campos de la respuesta estándar de 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 el comando ping, Atlas Data Federation prueba si un servidor responde a los comandos.

whatsmyuri

Para el comando whatsmyuri, Atlas Data Federation devuelve la dirección IP del cliente.