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. Puede usarlos para verificar qué particiones se utilizan para completar una colección, comprender la fecha de cálculo de 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 determinada. 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 admitidos por 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 roles disponibles.

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 determinada. Los siguientes valores son válidos para el sync parámetro:

• 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 obtener más información sobre los parámetros admitidos por este comando, consulte dbStats.

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

• object

• avgObjSize

• fsUsedSize

• fsTotalSize

El comando agrega los siguientes campos a la respuesta. Puede usarlos para determinar si el comando devolvió datos obsoletos.

explain

El comando explain devuelve información que describe el plan de consulta de la Federación de Datos. La explain salida difiere de la de MongoDB en que proporciona información sobre las particiones de datos utilizadas para satisfacer la consulta.

Los siguientes comandos se pueden explicar en Federación de Datos:

• 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 de 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 está respondiendo a los comandos.

whatsmyuri

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