idblockinfo

Lista información sobre los bloques de ID existentes para una familia de réplicas

Aplicabilidad

Producto Tipo de mandato
MultiSite Submandato multiutil
Plataforma
UNIX
Windows

Sinopsis

idblockinfo

[ –cl/an nombre-clan ] [ –site nombre-sitio ] –fam/ily nombre-familia
–u/ser nombre-usuario [ –p/assword contraseña ]
[-replica selector-réplica] [-ser/ies {req.uest|aux}]
[-long] [-update] {[-cur/rent] | [-all/_blocks]}  
[-sort propiedad[:{asc,desc}] [,propiedad[:{asc,desc}]...]

Descripción

El mandato idblockinfo lista información acerca de los bloques de ID existentes para una familia de réplicas. Cuando el mandato se ejecuta en el sitio maestro, proporciona la información más reciente sobre el estado general de los asignadores de ID de registro de base de datos. Cuando se ejecuta el mandato en un sitio de réplica, la información es preciosa para la última operación syncreplica -import del sitio maestro. Los valores del campo Disponible para los bloques de ID asignados a cada réplica están actualizados para la última operación syncreplica -import de dichas réplicas.

Opciones y argumentos

Especificación del clan, sitio y familia

Valor predeterminado
Clan: Primer clan replicado en este sitio. Si hay más de una conexión dbset registrada en este host, se necesita, –clan.

Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.

Familia: Sin valor predeterminado; debe especificar una familia.

–cl/an nombre-clan
Nombre del clan de la réplica.
–site nombre-sitio
Nombre del sitio de la réplica.
–fam/ily nombre-familia
Familia de base de datos de usuario: Nombre de base de datos que se da a la base de datos de usuario cuando se crea.

Especificación de un nombre de usuario y contraseña

Valor predeterminado
Debe especificar un nombre de usuario y contraseña.
–u/ser usuario
Nombre de un usuario con privilegios de superusuario.
–p/assword contraseña
Contraseña asociada al usuario especificado.

Especificación de las opciones de selección

-ser/ies series
El argumento de esta opción puede ser request o aux para limitar la salida a una de estas series de ID. Sin esta opción, se muestran bloques para ambas series.
-replica réplica
Se incluyen sólo los bloques de ID para la réplica indicada. Sin esta opción, se muestran bloques para todas las réplicas.
-all/_blocks
Muestra todos los bloques. Normalmente, los bloques que no tienen ningún ID disponible se omiten de la salida.
-cur/rent
Muestra sólo el bloque actual para la réplica identificada por las opciones de inicio de sesión. Esta opción sólo es válida para la réplica de inicio de sesión; si utiliza –replica > para identificar a otra réplica, se produce un error. Esta restricción es necesaria, ya que sólo puede determinarse el bloque actual de una réplica iniciando la sesión en dicha réplica.
-update
Actualiza el bloque de ID actual para la réplica identificada por las opciones de inicio de sesión. Esto hace que la información notificada para esa réplica sea lo más actualizada posible. La información para otras réplicas está actualizada según la última sincronización.

Especificación de las opciones de clasificación

-sort réplica, base, disponible, límite, hora_asignación, hora_disponible
Pueden especificarse varias propiedades, con una coma para separar la lista. La lista debe entrarse como un único argumento de línea de mandatos. Se permiten espacios de intervención, pero en ese caso debe ponerse la lista entera entre comillas. El orden de clasificación puede especificarse añadiendo un carácter de dos puntos y la palabra "asc" o "desc" para cualquiera de las propiedades. Por ejemplo, "-sort base:desc". La ordenación predeterminada es según la base.

Opciones de visualización

-long
Incluye la hora de asignación de bloque y la hora en que el recuento disponible se actualizó por última vez. Sin esta opción, estas dos columnas se omiten de la salida.

Ejemplos

En estos ejemplos, las líneas se quiebran para una mayor facilidad de lectura. Entre cada mandato en una sola línea.

  • Visualice el estado de bloques de ID para un clan, sitio y familia determinado. Sólo se devuelve el resultado de la serie de ID de solicitud. En este ejemplo se devuelve la base, límite, tamaño, los ID disponibles, porcentaje utilizado, familia y réplica de bloque de ID.

    multiutil idblockinfo -clan XYZ_CLAN -site XYZ_HQ
    -fam XYZ_DB -u admin "admin_pwd" -ser req

    REQUEST_SERIES
       Base   Limit   Size Available Pct  Family  Replica
      30979   35075   4096    1036   25%  XYZ_DB  Boston
      39171   43267   4096    3860   94%  XYZ_DB  Paris
      47363   51459   4096       1    0%  XYZ_DB  London
      55555   59651   4096     185    4%  XYZ_DB  Munich
      59651  134651  75000   75000  100%  XYZ_DB  Munich
    134651  209651  75000   68978   91%  XYZ_DB  London
    209651  284651  75000   35369   47%  XYZ_DB  Paris
    284651  359651  75000   74710   99%  XYZ_DB  Tokyo
    359651  434651  75000   55398   73%  XYZ_DB  Boston
    434651  509651  75000   46935   62%  XYZ_DB  Bejing
    509651  584651  75000   54600   72%  XYZ_DB  Brasilia
    584651  588747   4096    1248   30%  XYZ_DB  BejingA
    588747  592843   4096    1003   24%  XYZ_DB  TelAviv
    592843  682843  90000   12499   13%  XYZ_DB  TelAviv
    682843  772843  90000   39047   43%  XYZ_DB  BejingA
    772843  852843  80000   80000  100%  XYZ_DB  Paris

  • Vuelva a ejecutar el mismo mandato, pero incluya opciones adicionales para clasificar según valores de base por orden descendente y devolver sólo bloques de ID para la réplica Boston. La salida no se muestra debido a limitaciones de espacio.

    multiutil idblockinfo -clan XYZ_CLAN -site XYZ_HQ -fam XYZ_DB
    -u admin "admin_pwd" -ser req base:desc -replica Boston -long


Comentarios