Esta é a documentação do Looker. Para conferir a documentação do Looker Studio, acesse https://support.google.com/looker-studio.

Esta página foi traduzida pela API Cloud Translation.

Data warehouse autônomo do Oracle na nuvem

Como criptografar o tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo Looker e seu banco de dados. Considere uma das opções descritas na página de documentação Como ativar o acesso seguro ao banco de dados.

Configurar o host do Looker para conexões

Todas as conexões Oracle ADWC exigem autenticação SSL e certificado. Para que o Looker se conecte à sua instância do Oracle ADWC, é necessário fazer o download dos arquivos do Oracle Wallet e instalá-los no servidor do Looker. Se você for um usuário do Looker hospedado pelo cliente, vai precisar de um administrador do sistema com acesso ao servidor do Looker para fazer isso. Se você é um usuário hospedado pelo Looker, entre em contato com o suporte do Looker.

Para instalar o Oracle Wallet no servidor Looker:

Faça o download do Oracle Wallet no computador local. Você terá um arquivo ZIP com o nome Wallet_databasename.zip.
No servidor do Looker, crie um diretório para armazenar o arquivo ZIP da carteira:
```
mkdir /home/looker/looker/credentials
```
Copie o arquivo ZIP da carteira do seu computador local para o servidor do Looker. Este exemplo usa scp e coloca o arquivo em /home/looker/looker/credentials:
```
scp Wallet_databasename.zip username@remotehost:/home/looker/looker/credentials
```
Descompacte o arquivo ZIP da carteira. Este exemplo usa o comando unzip:
```
cd /home/looker/looker/credentials
unzip Wallet_databasename.zip
```
Verifique o conteúdo da carteira com o comando ls. Estes são os arquivos que você deve ter:
```
 ls

 cwallet.sso  keystore.jks      sqlnet.ora    truststore.jks
 ewallet.p12  ojdbc.properties  tnsnames.ora
```
O Looker se conecta ao Oracle ADWC usando Oracle Wallets com o JDBC Thin Driver 18.3. Para isso, você precisará do alias de substrato de rede transparente (TNS, na sigla em inglês) do nível do serviço Oracle ADWC para seu banco de dados e o caminho para os arquivos do Oracle Wallet.
Para receber o alias de TNS do seu banco de dados, execute este comando:
```
cat tnsnames.ora
```
Você poderá escolher entre três aliases de TNS: dbname_high, dbname_medium e dbname_low. Esses aliases correspondem a diferentes níveis de serviço. As informações de protocolo, host, porta, nome do serviço e SSL estão incluídas nesse arquivo. Neste exemplo, usaremos dbname_medium.

Criar um usuário do Looker

Primeiro, crie um usuário designado do Looker:

  -- connect / as sysdba;
  CREATE USER LOOKER IDENTIFIED BY <password>
  DEFAULT TABLESPACE USERS
  TEMPORARY TABLESPACE TEMP;

Em seguida, permita que o novo usuário do Looker crie sessões:

  GRANT CREATE SESSION TO LOOKER;

Por fim, conceda ao usuário do Looker as permissões SELECT apropriadas para as tabelas de dados que você planeja acessar pelo Looker. Se você quiser acessar outras tabelas no futuro, vai precisar conceder SELECT nessas novas tabelas também.

  GRANT SELECT ON -- <all tables that will be used by looker>;

Garantir que o Looker tenha acesso a todas as tabelas

O Looker pode não conseguir identificar tabelas (especialmente tabelas vazias) sem primeiro coletar estatísticas no Oracle. Se as tabelas necessárias não aparecerem no LookML gerado ou no SQL Runner, execute este comando:

  EXEC DBMS_STATS.GATHER_DATABASE_STATS;

Para conhecer métodos alternativos, consulte a documentação do Oracle.

Como configurar os principais objetos do banco de dados

Seu Oracle DBA precisa configurar os seguintes objetos e permissões no Oracle. Os comandos a seguir criam LOOKER_SESSION e LOOKER_SQL como sinônimos para V$SESSION e V$SQL.

Execute os comandos abaixo como usuário raiz para concluir esta configuração. Esses exemplos presumem que o nome do usuário do Looker seja LOOKER.

CREATE OR REPLACE VIEW LOOKER_SQL
AS
  SELECT
    sql.SQL_ID,
    sql.SQL_TEXT
  FROM
    V$SQL sql,
    v$session sess
  WHERE
    sess.SQL_ADDRESS = sql.ADDRESS AND
    sess.username=&apos;LOOKER&apos;;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SQL FOR LOOKER_SQL;

GRANT SELECT ON LOOKER.LOOKER_SQL TO LOOKER;

-- Pay special attention to the comments below:
-- the following view will be different for clustered Oracle deployments
CREATE OR REPLACE VIEW LOOKER_SESSION
AS
  SELECT
    SID,
    USERNAME,
    TYPE,
    STATUS,
    SQL_ID,
    -- If using a single node Oracle ADWC deployment
    "SERIAL#",
    -- If using a clustered Oracle ADWC deployment
    (SERIAL# || ',' || INST_ID) AS "SERIAL#",
    AUDSID
  -- If using a single node Oracle ADWC deployment
  FROM V$SESSION
  -- If using a clustered Oracle ADWC deployment
  FROM GV$SESSION
  WHERE
    USERNAME=&apos;LOOKER&apos;;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SESSION FOR LOOKER_SESSION;

GRANT SELECT ON LOOKER.LOOKER_SESSION TO LOOKER;

Como configurar agregados simétricos

O Oracle DBA precisa configurar a função LOOKER_HASH para ativar agregações simétricas. A função LOOKER_HASH é sinônimo da função dbms_crypto.hash do Oracle. Ele também precisa criar o sinônimo e os privilégios associados. O exemplo a seguir pressupõe que o nome do usuário do Looker seja LOOKER:

CREATE OR REPLACE FUNCTION LOOKER_HASH(bytes raw, prec number)
  RETURN raw AS
    BEGIN
  return(dbms_crypto.HASH(bytes, prec));
END;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_HASH FOR LOOKER_HASH;

GRANT EXECUTE ON LOOKER.LOOKER_HASH TO LOOKER;

GRANT EXECUTE ON SYS.LOOKER_HASH TO LOOKER;

Dependendo da configuração do banco de dados Oracle, o prefixo SYS pode ser SYSDBA, ADMIN ou desnecessário.

Como configurar tabelas derivadas persistentes

Para ativar as tabelas derivadas persistentes, conceda ao usuário do Looker as permissões UNLIMITED TABLESPACE e CREATE TABLE. Os comandos abaixo pressupõem que o nome do usuário do Looker é LOOKER:

GRANT UNLIMITED TABLESPACE TO LOOKER;
GRANT CREATE TABLE TO LOOKER;

Configurar a eliminação de consultas

Para configurar a eliminação de consultas, o Oracle DBA precisa criar o procedimento LOOKER_KILL_QUERY como sinônimo de ALTER SYSTEM KILL SESSION. Para isso, execute o seguinte comando:

CREATE OR REPLACE PROCEDURE LOOKER_KILL_QUERY(p_sid in varchar2,
                                              p_serial# in varchar2)
IS
  cursor_name pls_integer default dbms_sql.open_cursor;
  ignore pls_integer;

BEGIN
  SELECT
    COUNT(*) INTO IGNORE
  -- If using a single node Oracle ADWC deployment
  FROM V$SESSION
  -- If using a clustered Oracle ADWC deployment
  FROM GV$SESSION
  WHERE
    username = USER
    AND sid = p_sid
    -- If using a single node Oracle ADWC deployment
    AND serial# = p_serial#;
    -- If using a clustered Oracle ADWC deployment
    AND (SERIAL# || ',' || INST_ID) = p_serial#;

  IF (ignore = 1)
  THEN
    dbms_sql.parse(cursor_name,
                   &apos;ALTER SYSTEM KILL SESSION &apos;&apos;&apos;
                   || p_sid || &apos;,&apos; || p_serial# || &apos;&apos;&apos;&apos;,
                   dbms_sql.native);
    ignore := dbms_sql.execute(cursor_name);
  ELSE
    raise_application_error(-20001,
                            &apos;You do not own session &apos;&apos;&apos; ||
                            p_sid || &apos;,&apos; || p_serial# ||
                            &apos;&apos;&apos;&apos;);
  END IF;
END;

O DBA também precisará executar estes comandos relacionados:

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_KILL_QUERY FOR SYS.LOOKER_KILL_QUERY;
GRANT EXECUTE ON SYS.LOOKER_KILL_QUERY TO LOOKER;

Dependendo da configuração do banco de dados Oracle, o prefixo SYS pode ser SYSDBA, ADMIN ou desnecessário.

Como criar a conexão do Looker com seu banco de dados

Siga estas etapas para criar a conexão do Looker com seu banco de dados:

Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.
Preencher os detalhes de conexão. A maioria das configurações é comum à maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao banco de dados para mais informações. As configurações a seguir são específicas do Oracle ADWC:
- Dialeto: Oracle ADWC.
Observação :se você estiver em uma instância do Looker (Google Cloud Core) e não encontrar seu dialeto listado no menu suspenso Dialeto, consulte a documentação do Looker (Google Cloud Core) para verificar se ele tem suporte para instâncias do Looker (Google Cloud Core).
- Usar TNS: ative conexões de substrato de rede transparente (TNS, na sigla em inglês).
- Host: nome do host ou alias de TNS. Neste exemplo, dbname_medium.
- Port: deixe como padrão. O Looker vai encontrar a porta no arquivo tnsnames.ora.
- Service Name: deixe em branco. O Looker vai encontrar o nome do serviço no arquivo tnsnames.ora.
- Nome de usuário: nome de usuário do banco de dados ou banco de dados temporário se as PDTs estiverem ativadas.
- Senha: senha do usuário do banco de dados.
- Ativar TDPs: use esse botão para ativar as tabelas derivadas persistentes. Quando as TDPs são ativadas, a janela Conexão revela outras configurações de TDP e a seção Substituições de TDP.
- Banco de dados temporário: no Oracle, um usuário é um esquema, portanto, precisa ser especificado como o nome do usuário do banco de dados. Neste exemplo, você usaria o valor de esquema temporário LOOKER.
- Outros parâmetros do JDBC: o PATH para a carteira do Oracle no servidor do Looker. Neste exemplo, é /home/looker/looker/credentials.
- Em uma implantação legada hospedada pelo Looker, esse valor será /home/lookerops/looker/credentials.
- Em uma implantação hospedada pelo Looker em uma hospedagem de última geração, esse valor será /app/credentials.
- SSL e Verificar SSL: ignore esses campos. O Looker sempre usará SSL com o Oracle ADWC.
Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Como testar a conectividade do banco de dados para informações sobre solução de problemas. Quando você clica em Testar, o Looker cria uma string JDBC como esta:

jdbc:oracle:thin:@dbname_medium?TNS_ADMIN=/home/looker/looker/credentials
Para salvar essas configurações, clique em Conectar.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

O Oracle ADWC é compatível com os seguintes recursos a partir do Looker 24.10:

Engenharia de	Compatível?
Nível do suporte	Integração
Looker (Google Cloud Core)	No
Agregações simétricas	Sim
Tabelas derivadas	Sim
Tabelas derivadas de SQL persistentes	Sim
Tabelas derivadas nativas nativas	Sim
Visualizações estáveis	No
Eliminação de consultas	Sim
Dinâmicas baseadas em SQL	Sim
Fusos horários	Sim
SSL	Sim
Subtotais	Sim
Parâmetros adicionais do JDBC	No
Diferenciar maiúsculas e minúsculas	Sim
Tipo de local	Sim
Tipo de lista	Sim
Percentil	Sim
Percentil distinto	No
Processos de exibição do SQL Runner	Sim
Tabela de descrição do executor do SQL	Sim
Mostrar índices do SQL Runner	No
Seleção do SQL Runner 10	Sim
Contagem de executores do SQL	Sim
Explicação do SQL	No
Credenciais OAuth	No
Comentários de contexto	Sim
Pool de conexão	No
Esboços do HLL	No
Agregar reconhecimento	Sim
TDPs incrementais	No
Milissegundos	Sim
Microssegundos	Sim
Visualizações materializadas	No
Contagem aproximada diferente	No