Primeiros passos com o SIMBA Couchbase Driver ODBC
O ODBC existe desde o início dos anos 90 como uma API padrão para acessar várias fontes de dados, tradicionalmente em relação a fontes de dados estruturadas, como bancos de dados relacionais. A SIMBA Technologies lançou recentemente um driver ODBC para o Couchbase; isso abriu o Couchbase para várias ferramentas de integração de dados e relatórios de terceiros. Este é um guia de início rápido sobre como configurar o acesso ODBC para o Couchbase em uma estação de trabalho Windows com o SIMBA ODBC Driver for Couchbase.
Instalação dos drivers SIMBA ODBC
Requisitos de software para este guia
Sistema operacional Windows (Windows 7 ou superior)
Driver ODBC do SIMBA Couchbase 1.0.0.1000
Instalar os buckets de amostra do Couchbase (beer-sample e travel-sample)
Após a instalação, será necessário copiar o arquivo de licença fornecido pelo SIMBA para o diretório /lib.
Configuração do acesso ODBC ao Couchbase
O instalador configura um DSN de sistema de amostra chamado "Simba Couchbase ODBC DSN". Você pode revisar essa configuração com o utilitário ODBC Data Source Administrator, que é um utilitário do Painel de Controle do Windows.
-
Descrição: (Opcional)
-
Servidor: Especifique o nome do host ou o endereço IP de um nó do Couchbase que esteja executando o serviço de consulta do Couchbase 4.x. Neste exemplo, o driver está apontando para um nó local do Couchbase em execução no Windows 7.
-
Porta: Número da porta para o serviço de consulta do Couchbase 4.x (o padrão é 8093).
-
Opções avançadas: Esse assunto será abordado mais adiante neste blog.
- Definição do esquema: Esse assunto será abordado mais adiante no blog.
No ambiente de teste, verifique se o amostra de cerveja e amostra de viagem são carregados. Confirme isso no Console de administração do Couchbase | guia Data Buckets. Se os buckets não estiverem carregados, consulte a seção Site de documentação do Couchbase para obter instruções sobre como fazer isso.
Configuração rápida de definição de esquema
Um esquema serve como uma camada de tradução entre os dados do Couchbase e um formato compatível com ODBC. Um esquema pode ser armazenado em um arquivo JSON físico localizado em seu ambiente Windows local ou em cada bucket do Couchbase no cluster do Couchbase. Esta seção o orientará na transferência de um esquema para um cluster do Couchbase.
Etapa 1 - Criar índices primários nos buckets do Couchbase
Se ainda não o fez, você precisa de um índice primário nos documentos para que o driver SIMBA Couchbase ODBC reconheça os vários documentos e seus atributos armazenados em um bucket. Você precisará usar o índice Utilitário de linha de comando CBQ localizado no diretório bin. Neste exemplo, é criado um índice primário para os buckets beer-sample e travel-sample.
Etapa 2 - Revisar as opções avançadas
No painel DSN do driver ODBC do Couchbase, clique em Opções avançadas. As seguintes configurações devem ser observadas:
-
Query Mode (Modo de consulta) - SQL (padrão), emite uma consulta SQL; as consultas com falha serão enviadas como N1QL.
-
Comprimento da coluna de cadeia de caracteres - 1024 (padrão), especifica o comprimento da coluna para atributos de cadeia de caracteres.
-
Active Schema Location (Localização do esquema ativo) - Banco de dados (padrão), banco de dados ou arquivo de esquema JSON local usado pelo driver.
-
Tamanho da amostra - 100 (padrão), especifique o número de documentos que o driver digitaliza para gerar metadados de esquema.
-
Lista de nomes de tipos - Permite que o desenvolvedor especifique os tipos de documentos. O DSN padrão criado pelo instalador está configurado para funcionar com os três compartimentos de amostra: travel-sample, beer-sample e gamesim-sample.
Para os fins deste guia, é recomendável manter as configurações padrão no painel avançado.
Etapa 3 - Gerar um esquema e publicá-lo no banco de dados
Para configurar o ODBC para os buckets de amostra, siga as etapas a seguir:
-
Clique em Browse e aponte o driver para um arquivo json vazio em seu sistema local. Neste exemplo, foi especificado um arquivo vazio chamado NewCB.json, que estava localizado em c:odbc.
-
Clique em Generate Schema (Gerar esquema), o que pode demorar um pouco. Os metadados do esquema serão gravados no arquivo especificado na etapa anterior. Será exibida uma caixa de diálogo de sucesso.
-
Clique em Edit Schema File (Editar arquivo de esquema) para verificar o conteúdo do arquivo de esquema gerado:
- Se você quiser armazenar o esquema no banco de dados. Clique em Import Schema (Importar esquema) para gravar o esquema em cada bucket do Couchbase - você verá uma caixa de diálogo de sucesso. Isso pegará o conteúdo do arquivo JSON especificado na etapa 2 e o exportará para cada bucket no cluster do Couchbase. Agora você fez o upload do arquivo de esquema para o Couchbase!
Conclusão:
Com o lançamento dos drivers SIMBA Couchbase ODBC para Couchbase, os desenvolvedores agora têm acesso a uma ampla gama de ferramentas compatíveis com ODBC para usos como integração de dados, geração de relatórios e business intelligence. Esperamos que este guia o ajude a configurar o driver SIMBA ODBC para seu próprio ambiente de forma rápida e eficiente. Com o recente lançamento do Couchbase 4.1, os desenvolvedores agora podem executar operações DML no Couchbase via ODBC. blog de convidado de Mike Howard, da Simba Technologies.
Não tenho certeza se essa instrução ainda é válida para o driver mais recente da SIMA?
[Simba][Couchbase] (130) Não é possível conectar-se ao servidor Couchbase.
O ODBC genérico requer configuração adicional. O driver e o DSN (nome da fonte de dados) devem ser instalados e configurados para corresponder à conexão.
Não é possível conectar-se usando o DSN denominado "Sample Simba Couchbase ODBC DSN". Verifique se o DSN existe e se é uma conexão válida.
e da criação do esquema :
Ocorreu um erro durante a amostragem
Driver={Simba Couchbase ODBC Driver};AllowHostNameCNMismatch={0};AllowSelfSignedServerCert={0};AuthMech={0};CheckCertRevocation={0};CredFile={};Description={Sample Simba Couchbase ODBC DSN};Driver={Simba Couchbase ODBC Driver};IsTest={0};LocalSchemaFile={};LogFileCount={50};LogFileSize={20};Port={8093};QueryMode={0};Redundancy={0};SampleSize={100};ScanConsistency={0};Schema={default};SchemaMapOperation={0};Server={35.243.80.58};SimulateTransactions={0};SSL={0};StringColumnLength={255};TrustedCerts={C:\Program Files (x86)\Simba Couchbase ODBC Driver\lib\cacerts.pem};TypeNameList={
amostra de cerveja:tipo,amostra de viagem:tipo,gamesim-sample:jsonType};UseSystemTrustStore={0}@wirasakc - Não testei com os drivers SIMBA mais recentes, isso foi testado em uma versão lançada há mais de três anos.
Eu recomendaria que você consultasse os documentos do SIMBA - a última versão deles foi lançada no início de 2018.
https://www.simba.com/products/Couchbase/doc/ODBC_InstallGuide/win/content/odbc/intro.htm
Como alternativa, um colega acabou de escrever um blog sobre o uso do driver ODBC da CDATA, que é totalmente novo. https://www.couchbase.com/connecting-to-couchbase-via-odbc/
Eu daria uma olhada neste blog e experimentaria os drivers ODBC da CDATA -
https://www.couchbase.com/connecting-to-couchbase-via-odbc/