Nesta página, descrevemos as leituras direcionadas do Spanner e como usá-las.
As leituras direcionadas no Spanner oferecem a flexibilidade de rotear transações somente leitura e leituras únicas para um tipo ou região de réplica específica em uma configuração de instância multirregional ou uma configuração regional personalizada com regiões somente leitura opcionais.
Casos de uso comuns
Alguns casos de uso comuns para leituras direcionadas incluem:
- Faça o balanceamento de carga de cargas de trabalho em várias regiões para alcançar uma utilização mais uniforme da CPU.
- Isolar a análise no seu aplicativo minimizando o impacto nas cargas de trabalho transacionais.
- fornecer isolamento parcial para leituras de streams de alterações; Se você usar a API Spanner para fazer streaming de alterações de dados do Spanner, será possível minimizar o impacto nas cargas de trabalho transacionais usando leituras direcionadas.
Operações de consulta compatíveis
Operações de consulta | Leituras direcionadas são compatíveis? |
---|---|
Leitura desatualizada | Sim |
Leitura forte | Sim |
Transação de leitura/gravação | No |
As leituras direcionadas não são compatíveis com transações de leitura e gravação
e tipos de DML particionada de atualizações em massa. Isso ocorre porque as transações de leitura e gravação precisam ser processadas na região líder. Se
leituras direcionadas forem usadas em uma transação de leitura/gravação, a transação falhará com
um erro BAD_REQUEST
.
Limitações
As leituras direcionadas do Spanner têm as seguintes limitações:
- Só é possível usar leituras direcionadas em uma instância do Spanner que esteja em uma configuração de instância multirregional ou uma configuração regional personalizada com regiões somente leitura opcionais.
- Não é possível usar leituras direcionadas com solicitações de leitura/gravação porque elas são sempre atendidas pela região líder.
- Não é possível usar leituras direcionadas no console do Google Cloud ou na Google Cloud CLI. Ela está disponível usando as APIs REST e RPC e as bibliotecas de cliente do Spanner.
- É possível especificar no máximo 10 réplicas em uma única leitura direcionada.
- Se você usar o painel de insights do sistema ou o Metrics Explorer, nos gráficos de Operações por segundo, Operações por segundo por banco de dados e Operações por segundo por método da API, talvez sua solicitação de leituras direcionadas seja exibida em um local diferente do designado. Nesse caso, as informações dos gráficos podem estar incorretas. Confirme se as solicitações de leitura são roteadas para as regiões escolhidas usando as métricas de utilização da CPU. Essas métricas mostram as informações mais precisas sobre para onde o tráfego de leituras direcionadas é roteado.
Antes de começar
Considere o seguinte antes de usar leituras direcionadas:
- O aplicativo poderá gerar mais latência se você estiver roteando leituras para uma réplica ou região diferente da mais próxima do aplicativo.
- É possível rotear o tráfego com base em:
- Nome da região (por exemplo:
us-central1
). - Tipo de réplica (valores possíveis:
READ_ONLY
eREAD_WRITE
).
- Nome da região (por exemplo:
- A opção de failover automático em leituras direcionadas é ativada por padrão. Quando a opção de failover automático está ativada e todas as réplicas especificadas estão indisponíveis ou não íntegras, o Spanner encaminha solicitações para uma réplica fora da lista
includeReplicas
. Se você desativar a opção de failover automático e todas as réplicas especificadas estiverem indisponíveis ou não íntegras, a solicitação de leituras direcionadas falhará.
Parâmetros de leitura direta
Se você estiver usando a API REST ou RPC para executar leituras direcionadas, defina esses campos no parâmetro directedReadOptions
. Só é possível incluir um de
includeReplicas
ou excludeReplicas
, não ambos.
includeReplicas
: contém um conjunto repetido dereplicaSelections
. Essa lista indica a ordem em que as leituras direcionadas a regiões ou tipos de réplica específicos precisam ser consideradas. É possível especificar no máximo 10includeReplicas
.replicaSelections
: consiste emlocation
ou réplicatype
que atende à solicitação de leituras direcionadas. Se você usarincludeReplicas
, precisará fornecer pelo menos um dos seguintes campos:location
: o local que atende à solicitação de leituras direcionadas. O local precisa ser uma das regiões na configuração multirregional do seu banco de dados. Se o local não for uma das regiões na configuração multirregional do seu banco de dados, as solicitações não serão roteadas como esperado. Em vez disso, eles são atendidos pela região mais próxima. Por exemplo, é possível direcionar leituras para o localus-central1
em um banco de dados na configuração da instância multirregionalnam6
.type
: o tipo de réplica que atende à solicitação de leituras direcionadas. Os tipos possíveis incluemREAD_WRITE
eREAD_ONLY
.
autoFailoverDisabled
: por padrão, é definido comoFalse
, o que significa que o failover automático está ativado. Quando a opção de failover automático está ativada e todas as réplicas especificadas estão indisponíveis ou não íntegras, o Spanner encaminha solicitações para uma réplica fora da listaincludeReplicas
. Se você desativar a opção de failover automático e todas as réplicas especificadas estiverem indisponíveis ou não íntegras, a solicitação de leituras direcionadas falhará. Os valores possíveis incluemTRUE
para desativado eFALSE
para ativado.
excludeReplicas
: contém um conjunto repetido dereplicaSelections
que é excluído das solicitações de veiculação. O Spanner não encaminha solicitações para as réplicas dessa lista.replicaSelections
: o local ou o tipo de réplica que foi excluído de atender à solicitação de leituras direcionadas. Se você usaexcludeReplicas
, é necessário fornecer pelo menos um dos seguintes campos:location
: o local que foi excluído da veiculação da solicitação de leituras direcionadas.type
: o tipo de réplica que não pode atender à solicitação de leituras direcionadas. Os tipos possíveis incluemREAD_WRITE
eREAD_ONLY
.
Para ver um exemplo de corpo de solicitação REST, clique na guia REST na seção Usar leituras direcionadas.
Usar leituras direcionadas
É possível usar as bibliotecas de cliente do Spanner e as APIs REST e RPC para executar leituras direcionadas.
Bibliotecas de cliente
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
REST
É possível usar as seguintes APIs REST para executar leituras direcionadas:
Por exemplo, para executar leituras direcionadas em us-central1
usando executeSQL
:
Para a sessão, digite:
projects/<VAR>PROJECT-ID</VAR>/instances/<VAR>INSTANCE-ID</VAR>/databases/<VAR>DATABASE-ID</VAR>/sessions/<VAR>SESSION-ID</VAR>
Substitua:
- PROJECT-ID: o ID do projeto;
- INSTANCE-ID: o ID da instância
- DATABASE-ID: o ID do banco de dados.
- SESSION-ID: o ID da sessão.
Você recebe o valor
SESSION-ID
ao criar uma sessão.
Para o Corpo de solicitação, use o seguinte:
{ "directedReadOptions": { "includeReplicas": { "replicaSelections": [ { "location": "us-central1", } ] } }, "sql": "SELECT SingerId, AlbumId, AlbumTitle FROM Albums" }
Clique em Executar. A resposta exibe os resultados da consulta.
RPC
É possível usar as seguintes APIs RPC para executar leituras direcionadas:
A seguir
- Saiba como realizar Leituras fora das transações.