📿 ↕️ 🚉 Apresentando o Elasticsearch passo a passo ⏲️ 👩🏿‍🎤 🐑

Olá
Hoje falaremos sobre o mecanismo de pesquisa de texto completo Elasticsearch (doravante ES), com o qual
A plataforma Docsvision 5.5 está em execução.

1. Instalação

Você pode fazer o download da versão atual no link: www.elastic.co/downloads/elasticsearch
Screenshot do instalador abaixo:

2. Exame de Saúde

Após a conclusão da instalação, vá para
http: // localhost: 9200 /
Uma página com status de ES deve aparecer, um exemplo abaixo:

Se a página não abrir, verifique se o serviço Elasticsearch está em execução. No Windows, isso
Serviço de Elasticsearch.

3. Conexão com o Docsvision

A conexão com o Elasticsearch está configurada na página de serviço de texto completo
indexação.

Aqui você precisa especificar:
1. Endereço do servidor Elasticsearch (definido durante a instalação).
2. A cadeia de conexão com o DBMS.
3. Endereço da Docsvision (no formato ConnectAddress = http: // SERVER / DocsVision / StorageServer / StorageServerService.
asmx )
4. Na guia "Cartões" e "Diretórios", você precisa configurar os dados que
precisa ser indexado.
Você também precisa garantir que a conta na qual o serviço Docsvision esteja sendo executado
Serviço de indexação de texto completo, tem acesso ao banco de dados Docsvision no MS SQL.
Após a conexão, você precisa garantir que as tarefas com o prefixo sejam criadas no banco de dados MS SQL:
"DV: FullText_ <MNBD> _CardWithFilesPrepareRange"

Depois de concluir as configurações, a barra de pesquisa será desbloqueada no cliente Windows.

4. API REST Elastic

Um administrador pode obter várias informações sobre o Elasticsearch usando
fornecido pela API REST.
Nos exemplos a seguir, usaremos o Insomnia Rest Client.

Obtendo informações gerais

Depois que o serviço iniciar e começar a funcionar (http: // localhost: 9200 / no navegador), você poderá
execute a solicitação:
http: // localhost: 9200 / _cat / health? v

Obteremos uma resposta sobre o status do serviço Elasticsearch (no navegador):

Resposta ao status da insônia:

Preste atenção ao status - verde, amarelo, vermelho. A documentação oficial diz o seguinte sobre status:
• Verde - está tudo bem (o cluster está totalmente operacional)
• Amarelo - todos os dados estão disponíveis, mas algumas réplicas no cluster ainda não foram alocadas para eles.
• Vermelho - parte dos dados não está disponível por qualquer motivo (o próprio cluster está funcionando normalmente)
Obtendo estados sobre nós em um cluster e seu estado (eu tenho 1 nó):
http: // localhost: 9200 / _cat / nós? v

Todos os índices de ES:
http: // localhost: 9200 / _cat / índices? v

Além dos índices do Docsvision, pode haver índices de outros aplicativos - pulsação,
kibana - se você os usar. Necessário de desnecessário pode ser classificado. Por exemplo
pegue apenas os índices em nome dos quais há% card% no nome:
http: // localhost: 9200 / _cat / índices / * card *? v & s = index

Configuração do Elasticsearch

Obtendo as configurações do Elasticsearch:
http: // localhost: 9200 / _nodes
O resultado será bastante extenso, incluindo o caminho para os logs:

Como descobrir uma lista de índices, já sabemos, o Docsvision faz isso automaticamente, fornecendo um nome ao índice no formato:
<nome do banco de dados + visualização do cartão indexado>
Você também pode criar seu próprio índice independente:
http: // localhost: 9200 / customer? pretty
Só que não será um GET, mas uma solicitação PUT:

Resultado:

A consulta a seguir mostrará todos os índices, incluindo os novos (cliente):
http: // localhost: 9200 / _cat / índices? v

5. Obtendo informações sobre dados indexados

Status do índice Elasticsearch

Após a conclusão da configuração inicial do Docsvision, o serviço estará pronto para funcionar e iniciar a indexação de dados.
Primeiro, verificaremos se os índices foram preenchidos e se o tamanho é maior que os "bytes" padrão com a consulta que já sabemos:
http: // localhost: 9200 / _cat / índices? v
como resultado, vemos: 87 "tarefas" e 72 "documentos" são indexados em termos de nosso EDMS:

Após algum tempo, os resultados são os seguintes (por padrão, a indexação do trabalho é iniciada a cada 5 minutos):

Vemos que o número de documentos aumentou.

Como entender que o cartão desejado está indexado?

• Primeiro, verifique se o tipo de cartão no Docsvision corresponde aos dados especificados nas configurações do Elascticsearch.
• Em segundo lugar, aguarde a indexação da matriz de cartões - se ela entrar no Docsvision, levará algum tempo até que os dados apareçam no repositório.
• Em terceiro lugar, você pode procurar um cartão pelo CardID. Isso pode ser feito mediante solicitação:

http: // localhost: 9200 / _search? q = _id = 2116C498-9D34-44C9-99B0-CE89465637C9

Se o cartão estiver na loja, veremos seus dados "brutos"; caso contrário, veremos algo como esta resposta:

Procure um cartão no nó Elasticsearch

Encontre o documento pela correspondência exata do campo Descrição:
http: // localhost: 9200 / _search? q = descrição: tv de saída1
Resultado:

procure um documento que tenha uma entrada 'Caixa de entrada' em Descrição
http: // localhost: 9200 / _search? q = descrição como Entrada
Resultado:

Procure um cartão pelo conteúdo do arquivo anexado

Encontre todos os cartões do tipo de documento:
http: // localhost: 9200 / _search? q = _type: CardDocument

ou todos os cartões do tipo de tarefa:
http: // localhost: 9200 / _search? q = _type: CardTask

Usando as construções e os parâmetros que o Elasticsearch retorna como JSON, é possível montar a seguinte solicitação:
http: // localhost: 9200 / _search? q = _type: CardTask e Employee_RoomNumber: Office eagle e Employee_FirstName: Konstantin

Ele mostrará todos os cartões de tipo de trabalho, entre os usuários que possuem FirstName = Konstantin, e estão no Eagle Office.
Além de LIKE, existem outros parâmetros documentados:
diferentemente de campos, documentos, conteúdo etc.
Todos eles são descritos aqui .

Isso é tudo por hoje!

# docsvision # docsvisionECM

Links úteis:

Apresentando o Elasticsearch passo a passo