{"id":12715,"date":"2022-01-25T13:41:03","date_gmt":"2022-01-25T21:41:03","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=12715"},"modified":"2025-06-13T19:26:34","modified_gmt":"2025-06-14T02:26:34","slug":"analyzing-statistics-for-cost-based-optimization-in-couchbase-7-0","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/analyzing-statistics-for-cost-based-optimization-in-couchbase-7-0\/","title":{"rendered":"An\u00e1lise de estat\u00edsticas para otimiza\u00e7\u00e3o baseada em custos no Couchbase 7.0"},"content":{"rendered":"

Servidor Couchbase 7.0<\/a> (Enterprise Edition) introduziu um otimizador baseado em custo (CBO). As vers\u00f5es anteriores do Couchbase Server usavam um otimizador baseado em regras (RBO). O Couchbase Server evoluiu naturalmente do RBO para o CBO, como a maioria dos principais sistemas de bancos de dados relacionais.<\/p>\n

O CBO usa estimativas de custo para escolher um plano de consulta calculado a partir de estat\u00edsticas do otimizador. As estat\u00edsticas do otimizador s\u00e3o coletadas usando as instru\u00e7\u00f5es UPDATE STATISTICS ou ANALYZE em uma consulta SQL++ (denominada abaixo como N1QL).<\/p>\n

Declara\u00e7\u00e3o UPDATE STATISTICS\/ANALYZE<\/h4>\n

O novo UPDATE STATISTICS ou ANALYZE<\/em> acionam a coleta de estat\u00edsticas do otimizador necess\u00e1rias para a funcionalidade do CBO. Atualmente, um usu\u00e1rio emite essas novas instru\u00e7\u00f5es manualmente, o que calcula as estat\u00edsticas do otimizador no espa\u00e7o-chave\/cole\u00e7\u00e3o, os \u00edndices definidos no espa\u00e7o-chave\/cole\u00e7\u00e3o e as informa\u00e7\u00f5es de distribui\u00e7\u00e3o (como histogramas) em uma lista de termos (express\u00f5es).<\/p>\n

Quando h\u00e1 v\u00e1rios n\u00f3s de consulta, as estat\u00edsticas do otimizador coletadas de um n\u00f3 de consulta est\u00e3o dispon\u00edveis em todos os n\u00f3s de consulta.<\/p>\n

O novo N1QL_SYSTEM_BUCKET<\/strong><\/h5>\n

O novo otimizador coleta estat\u00edsticas por meio do ATUALIZA ESTAT\u00cdSTICAS\/AN\u00c1LISES<\/em> e os armazena em um novo bucket (N1QL_SYSTEM_BUCKET<\/em>), especificamente em um novo escopo (N1QL_SYSTEM_SCOPE<\/em>) e uma nova cole\u00e7\u00e3o (N1QL_CBO_STATS<\/em>).<\/p>\n

Na primeira vez em que \u00e9 executado, o ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> cria automaticamente esse novo bucket\/escopo\/cole\u00e7\u00e3o. Um \u00edndice prim\u00e1rio tamb\u00e9m \u00e9 criado automaticamente.<\/p>\n

Descarte do novo bucket\/escopo\/cole\u00e7\u00e3o<\/strong>
\nEsses novos objetos do sistema (bucket, escopo, cole\u00e7\u00e3o) podem ser descartados do banco de dados, o que faz com que todas as estat\u00edsticas do otimizador n\u00e3o estejam mais dispon\u00edveis.<\/p>\n

Qualquer consulta futura n\u00e3o aproveitar\u00e1 a funcionalidade CBO at\u00e9 que um usu\u00e1rio solicite que as estat\u00edsticas sejam analisadas novamente. At\u00e9 esse momento, o sistema volta ao RBO para o planejamento da consulta.<\/p>\n

Cota de mem\u00f3ria para o novo bucket\/escopo\/cole\u00e7\u00e3o<\/strong>
\nO novo balde do sistema (N1QL_SYSTEM_BUCKET<\/em>) \u00e9 criado com uma cota de mem\u00f3ria m\u00ednima de 100 MB. Em um sistema grande, os DBAs devem monitorar a resid\u00eancia de mem\u00f3ria no bucket e aumentar a cota de mem\u00f3ria quando necess\u00e1rio para evitar que a resid\u00eancia de mem\u00f3ria caia abaixo do n\u00edvel recomendado de 15%.<\/p>\n

Sintaxe<\/h5>\n

Em um alto n\u00edvel, h\u00e1 tr\u00eas aspectos de um comando UPDATE STATISTICS\/ANALYZE:
\n1. Estat\u00edsticas de espa\u00e7o-chave\/coleta<\/strong> - coletados toda vez que uma instru\u00e7\u00e3o de atualiza\u00e7\u00e3o\/an\u00e1lise \u00e9 emitida
\n2. Estat\u00edsticas do \u00edndice<\/strong> - coletados para \u00edndices \"relevantes
\n3. Estat\u00edsticas de distribui\u00e7\u00e3o (histograma)<\/strong> - reunidos nos termos especificados.<\/p>\n

H\u00e1 v\u00e1rias maneiras de especificar a lista de termos para os quais as estat\u00edsticas de distribui\u00e7\u00e3o s\u00e3o coletadas.<\/p>\n

Fornecimento de uma lista de termos para a cria\u00e7\u00e3o de estat\u00edsticas<\/strong><\/p>\n

UPDATE STATISTICS [FOR] keyspace(term1, term2, \u2026)\r\n\r\nANALYZE [KEYSPACE\/COLLECTION] keyspace(term1, term2, \u2026)<\/pre>\n
Essas duas declara\u00e7\u00f5es s\u00e3o equivalentes. A ESTAT\u00cdSTICAS DE ATUALIZA\u00c7\u00c3O<\/em> tem uma palavra-chave FOR opcional seguida de um nome de espa\u00e7o-chave. O comando ANALISAR<\/em> tem uma instru\u00e7\u00e3o opcional ESPA\u00c7O-CHAVE<\/em> ou COLE\u00c7\u00c3O<\/em> seguida de um nome de espa\u00e7o-chave.<\/p>\n
O nome do espa\u00e7o-chave \u00e9 normalmente um nome de cole\u00e7\u00e3o. Voc\u00ea pode especificar um nome de bucket como o nome do espa\u00e7o-chave; nesse caso, as estat\u00edsticas do otimizador s\u00e3o coletadas no Padr\u00e3o<\/em> coleta sob o Padr\u00e3o<\/em> escopo para esse balde.<\/p>\n
A lista de termos \u00e9 semelhante \u00e0 lista de express\u00f5es usadas no CRIAR \u00cdNDICE<\/em> declara\u00e7\u00e3o. De fato, qualquer express\u00e3o suportada em um CRIAR \u00cdNDICE<\/em> tamb\u00e9m pode ser usado como um termo em uma declara\u00e7\u00e3o ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o. Por exemplo:<\/p>\n
UPDATE STATISTICS FOR `travel-sample`.inventory.airport(city, country)\r\n\r\nANALYZE `travel-sample`.inventory.airport(city, country)<\/pre>\n
As declara\u00e7\u00f5es acima podem ser simplificadas se o contexto de consulta<\/em> \u00e9 definido como travel-sample.inventory:<\/em><\/p>\n
UPDATE STATISTICS FOR airport(city, country)\r\nANALYZE airport(city, country)<\/pre>\n
Express\u00e3o de chave funcional<\/strong><\/p>\n
Semelhante \u00e0 especifica\u00e7\u00e3o de uma chave de \u00edndice funcional em um CRIAR \u00cdNDICE<\/em> tamb\u00e9m \u00e9 poss\u00edvel especificar uma tecla de fun\u00e7\u00e3o em um comando ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o. Por exemplo:<\/p>\n
UPDATE STATISTICS FOR airport(lower(country))\r\n\r\nANALYZE airport(lower(country))<\/pre>\n
Express\u00e3o de chave de matriz<\/strong><\/p>\n
Como especificar uma chave de \u00edndice de matriz em um CRIAR \u00cdNDICE<\/em> tamb\u00e9m \u00e9 poss\u00edvel especificar uma chave de \u00edndice de matriz em uma instru\u00e7\u00e3o ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o. Por exemplo:<\/p>\n
UPDATE STATISTICS FOR route(DISTINCT ARRAY v.flight FOR v IN schedule END)\r\n\r\nANALYZE COLLECTION route(DISTINCT ARRAY v.flight FOR v IN schedule END)<\/pre>\n
ou usando a vers\u00e3o abreviada:<\/p>\n
UPDATE STATISTICS FOR hotel(ALL public_likes)\r\n\r\nANALYZE KEYSPACE hotel(ALL public_likes)<\/pre>\n
An\u00e1lise de um ou mais \u00edndices<\/strong><\/p>\n
Os comandos Analyze podem, opcionalmente, especificar um ou mais \u00edndices usando a op\u00e7\u00e3o \u00cdNDICE<\/em> op\u00e7\u00e3o:<\/p>\n
UPDATE STATISTICS FOR airport INDEX(def_inventory_airport_city, def_inventory_airport_faa)\r\n\r\nANALYZE airport INDEX(def_inventory_airport_city, def_inventory_airport_faa)<\/pre>\n
Quando o \u00cdNDICE<\/em> for especificada, a lista de express\u00f5es de chave de \u00edndice para todos os \u00edndices ser\u00e1 usada como a lista de termos para a op\u00e7\u00e3o ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o.<\/p>\n
Express\u00f5es no ONDE<\/em> para um \u00edndice parcial tamb\u00e9m s\u00e3o adicionados aos termos para an\u00e1lise. Assim, a cl\u00e1usula \u00cdNDICE<\/em> \u00e9 um atalho conveniente, pois o usu\u00e1rio n\u00e3o precisa listar todos os termos explicitamente.<\/p>\n
As declara\u00e7\u00f5es acima s\u00e3o equivalentes \u00e0s seguintes, pois cada \u00edndice tem apenas uma \u00fanica chave de \u00edndice e n\u00e3o h\u00e1 ONDE<\/em> para qualquer \u00edndice referenciado:<\/p>\n
UPDATE STATISTICS FOR airport(city, faa)\r\n\r\nANALYZE airport(city, faa)<\/pre>\n
An\u00e1lise de todos os \u00edndices<\/strong><\/p>\n
Para ir al\u00e9m, voc\u00ea pode usar a op\u00e7\u00e3o INDEX ALL para uma instru\u00e7\u00e3o UPDATE STATISTICS\/ANALYZE, que considera todos os \u00edndices dispon\u00edveis definidos na cole\u00e7\u00e3o e que est\u00e3o em um estado on-line. Por exemplo:<\/p>\n
UPDATE STATISTICS FOR airport INDEX ALL\r\n\r\nANALYZE airport INDEX ALL<\/pre>\n
Embora outras op\u00e7\u00f5es permitam que voc\u00ea especifique um nome de bucket ou um nome de cole\u00e7\u00e3o, a op\u00e7\u00e3o INDEXAR TUDO<\/em> s\u00f3 \u00e9 v\u00e1lida para uma cole\u00e7\u00e3o. Especificando INDEXAR TUDO<\/em> com um nome de bucket retornar\u00e1 um erro.<\/p>\n
\u00cdndice de resid\u00eancia<\/h5>\n
A an\u00e1lise tamb\u00e9m atualiza as estat\u00edsticas do otimizador para os \u00edndices relevantes. Quando uma lista de termos \u00e9 especificada, a lista de \u00edndices aplic\u00e1vel \u00e9 constru\u00edda verificando as chaves de \u00edndice que fazem refer\u00eancia a qualquer termo da lista. As listas de \u00edndices relevantes s\u00e3o deduzidas dos \u00edndices quando o par\u00e2metro \u00cdNDICE<\/em> ou \u00cdNDICE AL<\/em>A op\u00e7\u00e3o L \u00e9 usada.<\/p>\n
As estat\u00edsticas do otimizador de um \u00edndice s\u00f3 podem ser coletadas quando o \u00edndice \u00e9, pelo menos parcialmente, residente na mem\u00f3ria. As estat\u00edsticas do otimizador s\u00e3o coletadas da parte residente na mem\u00f3ria de um \u00edndice. Uma propor\u00e7\u00e3o maior de residentes na mem\u00f3ria produz estat\u00edsticas de otimizador mais precisas para esse \u00edndice.<\/p>\n
Se um \u00edndice tiver uma propor\u00e7\u00e3o de zero residente na mem\u00f3ria, os avisos a seguir ser\u00e3o retornados pelo comando de otimiza\u00e7\u00e3o:<\/p>\n
\"warnings\": [\r\n{\r\n\"code\": 5390,\r\n\"msg\": \"Index def_inventory_airport_city is not in memory\"\r\n}\r\n],<\/pre>\n
Cl\u00e1usula opcional WITH<\/h5>\n
Semelhante ao CRIAR \u00cdNDICE<\/em> voc\u00ea tamb\u00e9m pode especificar uma instru\u00e7\u00e3o opcional COM<\/em> para adicionar op\u00e7\u00f5es de an\u00e1lise estat\u00edstica. Por exemplo:<\/p>\n
UPDATE STATISTICS FOR airport(city, country) WITH {\"resolution\": 0.5}\r\n\r\nANALYZE airport(city, country) WITH {\"resolution\": 0.5}<\/pre>\n
As seguintes op\u00e7\u00f5es s\u00e3o atualmente suportadas no COM<\/em> cl\u00e1usula de um ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o: resolu\u00e7\u00e3o, sample_size, batch_size, update_statistics_timeout<\/em>. Cada um deles \u00e9 abordado a seguir.<\/p>\n
A op\u00e7\u00e3o de resolu\u00e7\u00e3o<\/strong><\/p>\n
A estat\u00edstica de distribui\u00e7\u00e3o do termo (histograma) \u00e9 representada como uma s\u00e9rie de \"compartimentos\". A resolu\u00e7\u00e3o indica qual porcentagem de documentos est\u00e1 representada em cada compartimento. Por padr\u00e3o, \u00e9 usada uma resolu\u00e7\u00e3o de 1,0 (ou seja, 100 compartimentos).<\/p>\n
Voc\u00ea pode especificar uma resolu\u00e7\u00e3o diferente na cl\u00e1usula WITH. Por exemplo, se voc\u00ea precisar de uma granularidade mais fina das estat\u00edsticas de distribui\u00e7\u00e3o, poder\u00e1 especificar uma resolu\u00e7\u00e3o menor (correspondente a um n\u00famero maior de compartimentos).<\/p>\n
Observe que quanto menor a resolu\u00e7\u00e3o (maior n\u00famero de compartimentos), mais amostras s\u00e3o necess\u00e1rias para construir o histograma e mais tempo\/recursos s\u00e3o necess\u00e1rios para concluir o processo. ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o.<\/p>\n
O intervalo v\u00e1lido da op\u00e7\u00e3o de resolu\u00e7\u00e3o \u00e9 de 0,02 a 5,0.<\/p>\n
A op\u00e7\u00e3o sample_size<\/strong><\/p>\n
As amostras s\u00e3o necess\u00e1rias para construir as estat\u00edsticas de distribui\u00e7\u00e3o (histograma) para os termos especificados em um ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o. A resolu\u00e7\u00e3o determina o tamanho da amostra e n\u00e3o est\u00e1 diretamente relacionada ao n\u00famero de documentos em uma cole\u00e7\u00e3o.<\/p>\n
Voc\u00ea pode especificar um tamanho de amostra a ser usado. No entanto, \u00e9 necess\u00e1rio um tamanho m\u00ednimo de amostra para uma determinada resolu\u00e7\u00e3o. Se o tamanho da amostra for menor do que o tamanho m\u00ednimo de amostra exigido, ser\u00e1 usado o tamanho m\u00ednimo de amostra exigido, e um aviso ser\u00e1 retornado.<\/p>\n
A op\u00e7\u00e3o batch_size<\/strong><\/p>\n
A constru\u00e7\u00e3o de histogramas exige uma opera\u00e7\u00e3o de classifica\u00e7\u00e3o e, portanto, consome muitos recursos. Para evitar a utiliza\u00e7\u00e3o excessiva de recursos, os histogramas s\u00e3o constru\u00eddos em lotes. Por padr\u00e3o, cada lote processa at\u00e9 10 termos para a constru\u00e7\u00e3o do histograma. Se houver mais termos listados ou se a combina\u00e7\u00e3o das express\u00f5es de chave de \u00edndice (dos \u00edndices especificados pelas op\u00e7\u00f5es INDEX) exceder dez termos, ser\u00e3o necess\u00e1rios v\u00e1rios lotes para processar todos os termos.<\/p>\n
Voc\u00ea pode especificar um tamanho_do_lote<\/em> para que o servidor saiba quantos termos devem ser processados em cada lote. Por exemplo, um usu\u00e1rio pode solicitar um tamanho de lote maior se o sistema n\u00e3o estiver ocupado e houver muitos recursos de computa\u00e7\u00e3o dispon\u00edveis. Por outro lado, se o sistema j\u00e1 estiver sobrecarregado, um tamanho de lote menor poder\u00e1 ser usado. \u00c9 um equil\u00edbrio entre o uso de recursos e a dura\u00e7\u00e3o da instru\u00e7\u00e3o de an\u00e1lise.<\/p>\n
A op\u00e7\u00e3o update_statistics_timeout<\/strong><\/p>\n
O ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> \u00e9 uma tarefa de manuten\u00e7\u00e3o e pode fazer com que o tempo de resposta seja significativamente maior do que o de uma simples consulta, especialmente quando s\u00e3o necess\u00e1rios v\u00e1rios lotes.<\/p>\n
Um valor de tempo limite de 60 segundos \u00e9 aplicado a um comando update\/analyze por padr\u00e3o. \u00c9 poss\u00edvel especificar um valor opcional (em segundos) para o valor de tempo limite. Observe que o valor de tempo limite se aplica a cada lote quando s\u00e3o necess\u00e1rios v\u00e1rios lotes.<\/p>\n
Cl\u00e1usula DELETE<\/h5>\n
Os usu\u00e1rios podem descartar as estat\u00edsticas atuais do otimizador usando um DELETE<\/em> com a instru\u00e7\u00e3o update\/analyze. Essa cl\u00e1usula desativa seletivamente o CBO para uma consulta ou conjunto de consultas.<\/p>\n
H\u00e1 algumas maneiras de especificar o DELETE<\/em> especificando uma lista de termos para os quais as estat\u00edsticas do otimizador ser\u00e3o exclu\u00eddas ou solicitando a exclus\u00e3o de todas as estat\u00edsticas do otimizador de um espa\u00e7o-chave\/cole\u00e7\u00e3o.<\/p>\n
Cl\u00e1usula DELETE com uma lista de termos<\/p>\n
UPDATE STATISTICS FOR airport DELETE (city, country)\r\n\r\nANALYZE COLLECTION airport DELETE STATISTICS(city, country)<\/pre>\n
A consulta excluir\u00e1 as estat\u00edsticas de distribui\u00e7\u00e3o somente para os termos especificados com essa op\u00e7\u00e3o. Outras estat\u00edsticas do otimizador, como espa\u00e7o-chave e estat\u00edsticas de \u00edndice, n\u00e3o ser\u00e3o afetadas. Com essa op\u00e7\u00e3o, se uma consulta tiver um predicado no campo \"city\" ou \"country\" da cole\u00e7\u00e3o \"airport\", o CBO ser\u00e1 desativado para a consulta.<\/p>\n
Cl\u00e1usula DELETE para todas as estat\u00edsticas do otimizador de um espa\u00e7o-chave\/cole\u00e7\u00e3o<\/p>\n
UPDATE STATISTICS FOR airport DELETE ALL\r\n\r\nANALYZE KEYSPACE airport DELETE STATISTICS<\/pre>\n
Com essa op\u00e7\u00e3o, todas as estat\u00edsticas do otimizador para a cole\u00e7\u00e3o \"airport\" ser\u00e3o exclu\u00eddas, incluindo estat\u00edsticas de espa\u00e7o-chave, estat\u00edsticas de \u00edndice e estat\u00edsticas de distribui\u00e7\u00e3o. Qualquer consulta que fa\u00e7a refer\u00eancia \u00e0 cole\u00e7\u00e3o \"airport\" ter\u00e1 o CBO desativado nesse caso.<\/p>\n
Quais campos\/express\u00f5es devem ser analisados?<\/h5>\n
Como posso saber quais campos\/express\u00f5es devo incluir em um ATUALIZAR ESTAT\u00cdSTICAS\/ANALISAR<\/em> declara\u00e7\u00e3o? Como regra geral, qualquer express\u00e3o referenciada em uma consulta (exceto aquelas apenas na cl\u00e1usula de proje\u00e7\u00e3o) requer estat\u00edsticas do otimizador.<\/p>\n
Cl\u00e1usulas WHERE, ON, GROUP BY, ORDER BY<\/p>\n
Express\u00f5es referenciadas no ONDE, EM, GRUPO POR<\/em> e ORDER BY<\/em> exigem estat\u00edsticas do otimizador. Por exemplo:<\/p>\n
SELECT a.airportname, r.airline\r\nFROM airport a JOIN route r ON a.faa = r.sourceairport\r\nWHERE a.city = \"San Francisco\"\r\nORDER BY a.airportname;<\/pre>\n
Para essa consulta, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
airport(faa, city, airportname)\r\nroute(sourceairport)<\/pre>\n
Se for usada uma express\u00e3o mais complexa:<\/p>\n
SELECT *\r\nFROM airport\r\nWHERE lower(country) = \"us\";<\/pre>\n
Para essa consulta, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
airport(lower(country))<\/pre>\n
Express\u00f5es de \u00edndice de matriz<\/strong><\/p>\n
Para QUALQUER<\/em> ou QUALQUER E TODOS<\/em> que utilizam \u00edndices de matriz, s\u00e3o necess\u00e1rias estat\u00edsticas do otimizador para a express\u00e3o de chave de \u00edndice de matriz correspondente. Por exemplo:<\/p>\n
SELECT *\r\nFROM route\r\nWHERE ANY v IN schedule SATISFIES v.flight = \"FL121\" END;<\/pre>\n
Para essa consulta, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
route(DISTINCT ARRAY v.flight FOR v IN schedule END)<\/pre>\n
Observe que a express\u00e3o usada \u00e9 a mesma que a express\u00e3o da chave do \u00edndice da matriz para a defini\u00e7\u00e3o do \u00edndice da matriz correspondente.<\/p>\n
Para um IN\u00daTIL<\/em> opera\u00e7\u00e3o:<\/p>\n
SELECT r.destinationairport\r\nFROM route r UNNEST r.schedule AS s\r\nWHERE s.flight = \"FL121\";<\/pre>\n
Para essa consulta, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
route(ALL ARRAY v.flight FOR v IN schedule END)<\/pre>\n
Novamente, a express\u00e3o usada \u00e9 a mesma que a express\u00e3o da chave de \u00edndice de matriz para a defini\u00e7\u00e3o de \u00edndice de matriz correspondente.<\/p>\n
Subconsulta e express\u00e3o de tabela comum (CTE)<\/strong><\/p>\n
Para uma consulta que envolva uma subconsulta ou um CTE, examine o bloco de consulta da subconsulta ou do CTE para determinar quais express\u00f5es exigem estat\u00edsticas do otimizador:<\/p>\n
WITH usairport AS (SELECT airportname, faa\r\nFROM airport\r\nWHERE lower(country) = \"us\")\r\nSELECT * FROM usairport;<\/pre>\n
Observando o bloco de consulta que define o CTE, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
airport(lower(country))<\/pre>\n
Fun\u00e7\u00f5es da janela<\/strong><\/p>\n
Se for usada uma fun\u00e7\u00e3o de janela, ser\u00e3o necess\u00e1rias estat\u00edsticas do otimizador nas express\u00f5es usadas nas cl\u00e1usulas PARTITION BY e ORDER BY:<\/p>\n
SELECT COUNT(1) OVER (PARTITION BY country)\r\nFROM airline;<\/pre>\n
Para essa consulta, as estat\u00edsticas do otimizador s\u00e3o necess\u00e1rias:<\/p>\n
airline(country)<\/pre>\n
Exibir estat\u00edsticas do otimizador<\/span><\/h5>\n
H\u00e1 dois novos espa\u00e7os de chave do sistema introduzidos para as estat\u00edsticas do otimizador: system:dictionary e system:dictionary_cache. O primeiro corresponde aos documentos em disco armazenados em N1QL_SYSTEM_BUCKET.N1QL_SYSTEM_SCOPE.N1QL_CBO_STATS,<\/em> enquanto o system:dictionary_cache corresponde \u00e0 representa\u00e7\u00e3o em cache na mem\u00f3ria de um subconjunto das mesmas informa\u00e7\u00f5es.<\/p>\n
O cache do dicion\u00e1rio \u00e9 inicializado quando um n\u00f3 de consulta \u00e9 iniciado, e as informa\u00e7\u00f5es do cache s\u00e3o preenchidas durante a execu\u00e7\u00e3o das consultas. Os dados recuperados do sistema:dicion\u00e1rio<\/em> ser\u00e1 o mesmo, independentemente do n\u00f3 de consulta que obtiver as informa\u00e7\u00f5es ao usar v\u00e1rios n\u00f3s de consulta.<\/p>\n
No entanto, as informa\u00e7\u00f5es armazenadas em cache de todos os n\u00f3s de consulta em um cluster de v\u00e1rios n\u00f3s estar\u00e3o em system:dictionary_cache,<\/em> em que cada n\u00f3 pode ter um subconjunto diferente de informa\u00e7\u00f5es armazenadas em cache.<\/p>\n
Essa consulta mostra a estat\u00edstica em system:dictionary:<\/p>\n
SELECT * FROM system:dictionary\r\nWHERE `bucket` = \"travel-sample\" AND `scope` = \"inventory\"\r\nAND `keyspace` = \"airport\";<\/pre>\n
Os resultados da consulta s\u00e3o:<\/p>\n
{\r\n\"dictionary\": {\r\n\"avgDocKeySize\": 12,\r\n\"avgDocSize\": 278,\r\n\"bucket\": \"travel-sample\",\r\n\"distributionKeys\": [\r\n\"country\",\r\n\"lower(country)\"\r\n],\r\n\"docCount\": 1968,\r\n\"indexes\": [\r\n{\r\n\"indexId\": \"4978a27d62bc592a\",\r\n\"indexName\": \"def_inventory_airport_primary\",\r\n\"indexStats\": [\r\n{\r\n\"avgItemSize\": 23,\r\n\"avgPageSize\": 7202,\r\n\"numItems\": 1968,\r\n\"numPages\": 6,\r\n\"resRatio\": 1\r\n}\r\n]\r\n},\r\n{\r\n\"indexId\": \"c5071b3ac2730bff\",\r\n\"indexName\": \"def_inventory_airport_faa\",\r\n\"indexStats\": [\r\n{\r\n\"avgItemSize\": 32,\r\n\"avgPageSize\": 9394,\r\n\"numItems\": 1968,\r\n\"numPages\": 7,\r\n\"resRatio\": 1\r\n}\r\n]\r\n},\r\n{\r\n\"indexId\": \"e260327a9933350e\",\r\n\"indexName\": \"def_inventory_airport_city\",\r\n\"indexStats\": [\r\n{\r\n\"avgItemSize\": 39,\r\n\"avgPageSize\": 11410,\r\n\"numItems\": 1968,\r\n\"numPages\": 7,\r\n\"resRatio\": 1\r\n}\r\n]\r\n}\r\n],\r\n\"keyspace\": \"airport\",\r\n\"namespace\": \"default\",\r\n\"scope\": \"inventory\"\r\n}\r\n}<\/pre>\n
Cada entrada cont\u00e9m informa\u00e7\u00f5es b\u00e1sicas sobre o espa\u00e7o-chave, uma matriz de distributionKeys<\/em> para os quais os histogramas est\u00e3o dispon\u00edveis e uma matriz de informa\u00e7\u00f5es de \u00edndice.<\/p>\n
Da mesma forma, ao consultar o system:dictionary_cache:<\/p>\n
SELECT * FROM system:dictionary_cache\r\nWHERE `bucket` = \"travel-sample\" AND `scope` = \"inventory\"\r\nAND `keyspace` = \"airport\";<\/pre>\n
O resultado \u00e9 o mesmo que o sistema:dicion\u00e1rio<\/em> exceto por um campo de n\u00f3 extra que mostra entradas de diferentes n\u00f3s de consulta.<\/p>\n
Explicar a sa\u00edda com optimizer_estimates<\/h5>\n
Quando as estat\u00edsticas apropriadas do otimizador estiverem dispon\u00edveis, a sa\u00edda do EXPLAIN conter\u00e1 uma nova se\u00e7\u00e3o optimizer_estimates para cada operador. Essas se\u00e7\u00f5es refletem a estimativa do otimizador para as informa\u00e7\u00f5es de custo desse operador e de todos os seus filhos. Por exemplo:<\/p>\n
EXPLAIN SELECT * FROM airport WHERE city = \"San Francisco\";<\/pre>\n
A sa\u00edda a seguir \u00e9 para o operador IndexScan3:<\/p>\n
{\r\n\"#operator\": \"IndexScan3\",\r\n\"index\": \"airpot_city_country\",\r\n\u2026\u2026\r\n\"optimizer_estimates\": {\r\n\"cardinality\": 1.1764705882352944,\r\n\"cost\": 12.212415941159103,\r\n\"fr_cost\": 12.180553549985238,\r\n\"size\": 12\r\n},\r\n\"spans\": [\r\n\u2026\u2026\r\n],\r\n\u2026\u2026\r\n},<\/pre>\n
Ter o otimizador_estimativas<\/em> para um operador \u00e9 uma indica\u00e7\u00e3o de que o banco de dados est\u00e1 usando o CBO para esse est\u00e1gio do processo de planejamento da consulta.<\/p>\n
Resumo<\/h4>\n
Novos recursos inovadores de banco de dados foram disponibilizados no Couchbase 7.0; a adi\u00e7\u00e3o do Cost-Based Optimizer (CBO) \u00e9 apenas um dos muitos. As consultas de atualiza\u00e7\u00e3o\/an\u00e1lise mostradas nesta postagem do blog s\u00e3o essenciais para coletar as estat\u00edsticas necess\u00e1rias para que o CBO funcione com efici\u00eancia.<\/p>\n
Quando o banco de dados re\u00fane estat\u00edsticas precisas do otimizador, a sa\u00edda EXPLAIN mostra as estimativas que o CBO usar\u00e1 para escolher um plano de consulta. Isso ajudar\u00e1 a orient\u00e1-lo para uma gera\u00e7\u00e3o de consultas mais eficiente e previs\u00edvel no futuro.<\/p>\n