idblockinfo

Lista informações sobre os blocos de IDs existentes para uma família de réplicas.

Aplicabilidade

Produto Tipo de Comando
MultiSite Subcomando de multiutil
Plataforma
UNIX®
Windows®

Sinopse

idblockinfo

[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [ –p/assword password ]
[-replica replica-selector] [-ser/ies {req.uest|aux}]
[-long] [-update] {[-cur/rent] | [-all/_blocks]}  
[-sort property[:{asc,desc}] [,property[:{asc,desc}]...]

Descrição

O comando idblockinfo lista informações sobre os blocos de IDs existentes para uma família de réplicas. Quando o comando é executado no site master, ele fornece as informações mais recentes sobre o estado geral dos alocadores de IDs do registro do banco de dados. Quando o comando é executado em um site de réplica, as informações são exatas para a última operação syncreplica -import do site master. Os valores do campo Disponível para os blocos de IDs designados a cada réplica são atuais para a última operação syncreplica -import dessas réplicas.

Opções e Argumentos

Especificando o Clã, o Site e a Família

Padrão
Clã: primeiro clã replicado nesse site. Se houver mais de uma conexão dbset registrada nesse host, –clan será obrigatório.

Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.

Família: nenhum padrão; você deve especificar uma família.

–cl/an clan-name
Nome do clã da réplica.
–site site-name
Nome do site da réplica.
–fam/ily family-name
Família do banco de dados do usuário: nome fornecido ao banco de dados do usuário quando ele foi criado.

Especificando um Nome de Usuário e uma Senha

Padrão
Você deve especificar um nome de usuário e uma senha.
–u/ser user
Nome de um usuário com privilégios de superusuário.
–p/assword password
Senha associada ao usuário especificado.

Especificando as Opções de Seleção

-ser/ies series
O argumento para essa opção pode ser request ou aux para limitar a saída de uma dessas séries de IDs. Sem essa opção, os blocos para ambas as séries são mostrados.
-replica replica
Inclui apenas os blocos de IDs da réplica nomeada. Sem essa opção, são mostrados os blocos de todas as réplicas.
-all/_blocks
Mostra todos os blocos. Normalmente, os blocos que não possuem IDs disponíveis são omitidos da saída.
-cur/rent
Mostra apenas o bloco atual da réplica identificada pelas opções de logon. Esta opção é válida apenas para a réplica de logon, e ocorrerá um erro se –replica for utilizado para identificar outra réplica. Essa restrição é necessária, pois o bloco atual de uma réplica somente pode ser determinado por meio do login nessa réplica.
-update
Atualiza o bloco de IDs atual para a réplica identificada pelas opções de logon. Isso faz com que as informações relatadas nessa réplica sejam as mais atuais possíveis. As informações de outras réplicas são atuais tanto quanto a última sincronização.

Especificando as Opções de Classificação

-sort replica, base, available, limit, allocation_time, available_time
Múltiplas propriedades podem ser especificadas, com uma vírgula para separar a lista. A lista deve ser digitada como um único argumento da linha de comandos. Espaços interpostos são permitidos; mas, nesse caso, a lista inteira deve ser colocada entre aspas. A ordem de classificação pode ser especificada anexando dois-pontos e a palavra "asc" ou "desc" a qualquer uma das propriedades. Por exemplo, "-sort base:desc". A ordenação padrão é por base.

Opções de Exibição

-long
Inclui o tempo de alocação de bloco e o horário da última atualização da contagem disponível. Sem essa opção, essas duas colunas são omitidas da saída.

Exemplos

Nestes exemplos, as linhas são quebradas por questões de legibilidade. Cada comando deve ser digitado em uma única linha.

  • Exiba o status de blocos de IDs para um determinado clã, site e família. Retorne apenas os resultados da série de IDs do pedido. Este exemplo retorna o bloco de IDs base, o limite, o tamanho, os IDs disponíveis, a porcentagem utilizada, a família e a réplica.

    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

  • Execute novamente o mesmo comando, mas inclua opções adicionais para classificar por valores base em ordem decrescente e para retornar apenas blocos de IDs para a réplica Boston. A saída não é mostrada devido a limitações de espaço.

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


Feedback