1. Usando a Interface de Usuário do Oracle Machine Learning no Autonomous Database
  2. Administrar o Oracle Machine Learning

12 Administre o Oracle Machine Learning

O Oracle Machine Learning é gerenciado no nível do sistema e no nível do aplicativo por um administrador.

  • Administrador - Cria e gerencia contas de usuário do Oracle Machine Learning, gerencia recursos de computação, grupos de conexões e sessões de notebook. O Administrador também reatribui o espaço de trabalho do usuário.

    Observação:

    O Administrador não está autorizado a executar notebooks. O Administrador só pode ler notebooks.
    Home page do administrador e menu de navegação esquerdo

  • Desenvolvedor - Esta é a atribuição de usuário padrão que permite criar e executar notebooks, executar Instruções SQL, criar scripts SQL, executar scripts Python, criar jobs para programar e executar notebooks, usar notebooks de modelo de exemplo, criar e executar experimentos AutoML e implantar modelos.Home page do desenvolvedor e menu de navegação à esquerda

12.1 Workflow Típico para Gerenciar o Oracle Machine Learning

Para gerenciar a Interface do Usuário do Oracle Machine Learning e outras tarefas administrativas, consulte as tarefas listadas na tabela como guia.

Tarefas Interface CLI do Oracle Machine Learning/OCI Mais informações
Obtenha o URL de Gerenciamento de Usuários do Oracle Machine Learning na linha de comando do OCI Command Line Interface (CLI) do Oracle Cloud Infrastructure (OCI) Acessar o Gerenciamento de Usuários OML da Linha de Comando
Conta de usuário e criação de senha Interface de Gerenciamento de Usuários do Oracle Machine Learning Criar Usuários para o Oracle Machine Learning
Grupos de Conexões - Exibir e Redefinir Interface de Usuário do Oracle Machine Learning Trabalhar com Grupos de Conexões
Recurso de Computação - Exibir Interface de Usuário do Oracle Machine Learning Sobre o Recurso de Computação
Administração de Dados do Usuário - Exclui todos os usuários, todos os objetos relacionados ao usuário, como espaço de trabalho, projetos e notebooks, e reatribuição do espaço de trabalho Interface de Usuário do Oracle Machine Learning Sobre Dados do Usuário
Sessão de notebook - Carregamento e interrupção de sessões de notebook Interface de Usuário do Oracle Machine Learning Conceitos Básicos das Sessões de Notebook
Ambiente Conda - Instalação e gerenciamento do ambiente Conda, adição e exclusão de pacotes do ambiente. Oracle Autonomous Database Sobre o Ambiente Conda e o Interpretador Conda

Observação:

As tarefas listadas aqui podem ser executadas apenas por um administrador.

Tópico principal: Administrar o Oracle Machine Learning

12.2 Acessar o Gerenciamento de Usuários do OML na Linha de Comando

Você pode obter o URL de Gerenciamento de Usuários do Oracle Machine Learning para uma tenancy específica na linha de comando do OCI (Oracle Cloud Infrastructure).

Pré-requisito: ID da Tenancy
Para obter o URL de Gerenciamento de Usuários do Oracle Machine Learning para uma tenancy específica na linha de comando do OCI, primeiro obtenha o ID da tenancy.
  1. Para obter o ID da tenancy, vá para o Perfil do OCI no canto superior direito da página do Oracle Cloud e clique em Tenancy.

    Figura 12-1 Perfil do OCI

    Informações sobre o Perfil do Oracle Cloud
  2. Na página de detalhes da Tenancy, clique em Copiar para obter o URL da tenancy.

    Figura 12-2 Informações da Tenancy

    Informações da Tenancy
  3. Digite o seguinte comando na sua interface de linha de comando do OCI:
    oci db database list  --compartment-id  <tenancy OCID>
    Aqui,
    • compartment-id: Este é o ID exclusivo designado ao seu compartimento.
    • tenancy OCID: Este é o OCID (Oracle Cloud Identifier) da sua tenancy.
    Este comando retorna o seguinte:
    "connection-urls": {
        "apex-url": https://<tenancy ID>-<database name>.<region>.oraclecloudapps.com/ords/apex,
        "graph-studio-url": https://<tenancy ID>-<database name>.<region>.oraclecloudapps.com/graphstudio/,
        "machine-learning-user-management-url": https://<tenancy ID>-<database name>.<region>-1.oraclecloudapps.com/omlusers/,
        "sql-dev-web-url": https://<tenancy ID>-<database name>.<region>-1.oraclecloudapps.com/ords/sql-developer
      },
Concluída a tarefa de obter o URL de Gerenciamento de Usuário do Oracle Machine Learning na interface de linha de comando do OCI.

Tópico principal: Administrar o Oracle Machine Learning

12.3 Gerenciar Usuários do OML

Um administrador gerencia a criação de novas contas e credenciais de usuário para o Oracle Machine Learning na interface de Gerenciamento de Usuários.

Tópico principal: Administrar o Oracle Machine Learning

12.3.1 Criar Usuário

Um administrador cria novas contas e credenciais de usuário para o Oracle Machine Learning na interface de Gerenciamento de Usuários.

Observação:

Você deve ter a função de administrador para acessar a interface de Gerenciamento de Usuários do Oracle Machine Learning.

Para criar uma conta de usuário:

  1. Na página dos Autonomous Databases, em Nome para Exibição, selecione um Autonomous Database.
  2. Na página Detalhes do Autonomous Database, clique em Database Actions.
  3. Na plataforma de inicialização do Database Actions, em Administração, clique em Usuários de Banco de Dados.
  4. Clique em + Criar Usuário.
  5. No campo Nome do Usuário, digite um nome de usuário para a conta. Usando o nome de usuário, o usuário fará log-in em uma instância do Oracle Machine Learning.
  6. (Opcional) Selecione a opção Password Expired (user must change). para exigir que o usuário altere a senha ao fazer login pela primeira vez.
  7. No campo Senha, insira a senha para o usuário.
  8. No campo Confirmar Senha, digite uma senha para confirmar o valor informado no campo Senha.
  9. Selecione OML para ativar o Oracle Machine Learning para o usuário.
  10. Clique em Criar Usuário.

Isso cria um novo usuário de banco de dados e concede os privilégios obrigatórios para usar o Oracle Machine Learning.

Observação:

Com um novo usuário de banco de dados, um administrador precisa emitir comandos de concessão no banco de dados para conceder acesso de tabela ao novo usuário para as tabelas associadas aos notebooks do Oracle Machine Learning do usuário.

Tópico principal: Gerenciar Usuários do OML

12.3.2 Adicionar Conta existente de usuário de banco de dados aos componentes do Oracle Machine Learning

Como usuário ADMIN, você pode adicionar uma conta existente de usuário de banco de dados para componentes do Oracle Machine Learning.

Observação:

Você deve ter a atribuição ADMIN para acessar a interface de Gerenciamento de Usuários do Oracle Machine Learning.

To add an existing database user account:

  1. Na página do Autonomous Database, na coluna Nome para Exibição, selecione um Autonomous Database.
  2. Na página Detalhes do Autonomous Database, clique em Database Actions.
  3. No Launchpad do Database Actions, em Desenvolvimento, clique em Oracle Machine Learning.
  4. Expanda o navegador clicando em ícone de navegação ao lado do Oracle Machine Learning.
  5. Em Admin, selecione Gerenciar Usuários do OML para adicionar usuários do Oracle Machine Learning Notebooks.
  6. Clique em Mostrar Todos os Usuários para exibir os usuários existentes do banco de dados.

    Veja a seguir a descrição da ilustração dwcs_oml_show_all_users.png
    Descrição da ilustração dwcs_oml_show_all_users.png

    Observação:

    Inicialmente, o campo Atribuição mostra a atribuição Nenhum para usuários existentes do banco de dados. Depois de adicionar um usuário, a atribuição Developer é designada ao usuário.
  7. Selecione um usuário. Para selecionar um usuário, selecione um nome na coluna Nome do Usuário. Por exemplo, selecione ANALYST1.
    A seleção do usuário mostra a página Editar Usuário do Oracle Machine Learning.
  8. Insira um nome no campo Nome. (Opcional )
  9. Digite o sobrenome do usuário no campo Sobrenome. (Opcional )
  10. No campo Endereço de E-mail, digite o ID de e-mail do usuário.
    Qualquer alteração feita nessa página adiciona o usuário existente do banco de dados como usuário do componente do Oracle Machine Learning com os privilégios obrigatórios.
  11. Clique em Salvar.

Isso concede os privilégios obrigatórios para usar o aplicativo Oracle Machine Learning. No Oracle Machine Learning, esse usuário pode acessar todas as tabelas que ele tem privilégios para acessar no banco de dados.

Tópico principal: Gerenciar Usuários do OML

12.4 Sobre Dados do Usuário

Na página Dados do Usuário no Oracle Machine Learning, você pode exibir dados do usuário existentes, reatribuí-los e excluí-los.

A página Dados do Usuário lista detalhes do usuário do Oracle Machine Learning, como nome, função, comentários, data da última atualização. É possível executar estas tarefas:

  • Excluir Dados do Usuário: Para excluir um usuário, selecione o usuário a ser excluído e clique em Excluir Dados do Usuário.

  • Reatribuir: Para reatribuir o espaço de trabalho e os modelos de um usuário para outro.

  • Reatribuir
    A opção Reatribuir permite que você reatribua espaços de trabalho, juntamente com modelos, de um usuário para outro.

Tópico principal: Administrar o Oracle Machine Learning

12.4.1 Redesignar

A opção Reatribuir permite que você reatribua espaços de trabalho, juntamente com modelos, de um usuário para outro.

Para reatribuir espaços de trabalho:
  1. Na página Dados do Usuário, selecione o usuário do qual deseja reatribuir o espaço de trabalho e clique em Reatribuir.
    A página Reatribuir é aberta.
  2. No campo Usuário de Destino, selecione o usuário ao qual você deseja designar novamente o espaço de trabalho.
  3. Selecione Todos os Modelos se quiser reatribuir todos os modelos associados ao usuário selecionado na página Dados do Usuário.
  4. Selecione:
    • Designar novamente todos os espaços de trabalho: Para designar novamente todos os espaços de trabalho associados ao usuário selecionado.
    • Selecionar espaços de trabalho a serem redesignados: Para redesignar espaços de trabalho específicos associados ao usuário selecionado.
  5. Clique em Redesignar.
Depois que os modelos e espaços de trabalho forem reatribuídos com sucesso, uma mensagem de notificação será exibida na página Dados do Usuário com o número de modelos e espaços de trabalho reatribuídos.

Tópico principal: Sobre Dados do Usuário

12.5 Sobre o Recurso de Computação

O termo Recurso de Computação refere-se a serviços como um banco de dados ou qualquer outro serviço de backend ao qual um interpretador se conecta.

Observação:

Você deve ter a atribuição de Administrador para acessar a página Recursos de Computação.

A página Recursos de Computação exibe a lista de recursos de computação com o nome de cada recurso, seu tipo, comentários e detalhes atualizados pela última vez. Para exibir detalhes de cada Recurso de Computação, clique no nome do Recurso de Computação. Os detalhes da conexão são exibidos na página Recursos Oracle.

  • Recurso Oracle
    A página Recurso Oracle exibe os detalhes do recurso de computação selecionado na página Recursos do Serviço Compute. Você pode configurar as definições de memória (em Gigabytes) para o interpretador Python para o recurso de computação selecionado.

Tópico principal: Administrar o Oracle Machine Learning

12.5.1 Recurso do Oracle

A página Recurso Oracle exibe os detalhes do recurso de computação selecionado na página Recursos do Serviço Compute. Você pode configurar as definições de memória (em Gigabytes) para o interpretador Python para o recurso de computação selecionado.

Observação:

Você deve ter o privilégio Administrador para configurar as definições de memória.

Figura 12-3 Recurso Oracle

A descrição da Figura 12-3 é exibida a seguir
Descrição da "Figura 12-3 Recurso Oracle"
Para gerenciar definições de memória para o interpretador Python:
  1. Nome: Exibe o nome do recurso selecionado.
  2. Observação: Exibe o comentário, se houver.
  3. Memória: Você pode configurar definições de memória (em Gigabytes) para interpretadores Python neste campo.
    • Para o recurso databasename_high, as definições de memória (em Gigabytes) devem estar entre 8 e 16
    • Para o recurso databasename_medium, as definições de memória (em Gigabytes) devem estar entre 4 e 8
    • Para o recurso databasename_low, as definições de memória (em Gigabytes) devem estar entre 2 e 4

    Observação:

    A definição Memória só é aplicável para o interpretador Python.
  4. Tipo de Conexão: Exibe a conexão de banco de dados do recurso.
  5. Alias da Rede: Exibe o alias da conexão de rede.

Tópico principal: Sobre o Recurso de Computação

12.5.1.1 Serviços de Recursos e Notebooks

Este tópico lista o número de notebooks que você pode executar simultaneamente por PDB para cada serviço de Recurso.

A tabela Serviços de Recursos e Número de Notebooks lista os Recursos de Computação designados para execução de scripts Python em diferentes níveis de Serviço de Recursos - Alto, Médio e Baixo. O nível Alto recebe o número máximo de Recursos de Computação para executar o script Python, o que pode resultar em uma execução mais rápida dos scripts. O nível Baixo recebe o menor número de Serviços de Recursos, o que resulta em uma execução mais lenta dos scripts.

Tabela 12-1 Serviços de Recursos e Número de Notebooks

Serviço do Recurso OCPUs (CPUs da Oracle) Memória Número de Notebooks Concorrentes
High Até 8 OCPUs 8 GB (até 16 GB) Até 3
Medium Até 4 (OCPUs) 4 GB (até 8 GB) Até o máximo (1,25 × número de OCPUs)

Observação:

O número de execução de notebook atual é calculado pela fórmula 1.25 x (number of OCPUs) provisionada para o PDB correspondente. OCPU significa Oracle CPU.

Por exemplo, se um PDB for provisionado com 4 OCPUs, o número máximo de notebooks executados será 5 (1,25 x 4) no nível Médio.
Low 1 2 GB (até 4 GB) Até 100

Tópico pai: Recurso Oracle

12.6 Conceitos Básicos de Grupos de Conexões

Um grupo de conexões, também conhecido como conjunto de interpretadores Zeppelin, é uma coleção de conexões de banco de dados.

  • Sobre Grupos de Conexões
    Na página Grupo de Conexões, um usuário com a atribuição Administrador pode gerenciar suas conexões que constituem o grupo de conexões.
  • Sobre o Grupo de Conexões Global
    O Grupo de Conexões Global é criado automaticamente quando um novo banco de dados é provisionado.
  • Editar Conexão do Interpretador do Oracle Database
    Ao definir uma conexão do interpretador do Oracle Database, uma referência a um recurso de computação é criada. Esta referência contém todas as informações relacionadas à conexão sobre o interpretador.

Tópico principal: Administrar o Oracle Machine Learning

12.6.1 Sobre Grupos de Conexões

Na página Grupo de Conexões, um usuário com a atribuição Administrador pode gerenciar suas conexões que constituem o grupo de conexões.

Você pode Editar e Interromper uma ou mais conexões listadas em um grupo de conexões nesta página.

Observação:

Somente um usuário Administrador pode gerenciar grupos de conexões.
As seguintes informações sobre as conexões estão disponíveis:

  • Nome: Este é o nome do interpretador.

  • Padrão: Uma marca de seleção indica se a conexão é padrão ou não.

  • Escopo: Indica o escopo da conexão.

  • Comentário: Exibe qualquer comentário relacionado ao interpretador.

  • Proprietário: Exibe o nome do usuário que criou a conexão.

  • Última Atualização: Indica a data e a hora da última atualização da conexão.

É possível executar estas tarefas:

  • Editar: Para editar a conexão do interpretador, selecione a conexão e clique em Editar.

  • Stop: Para interromper a conexão do interpretador, selecione a conexão e clique em Stop.

  • Atualizar: Clique no botão Atualizar nas seguintes condições:
    • Se você renomear o PDB (Banco de Dados Plugável).
    • Se você fizer uma rotação de Wallet. A rotação da wallet invalida a wallet atual. Portanto, uma nova Wallet é necessária para a conexão do banco de dados.

Tópico principal: Conceitos Básicos dos Grupos de Conexões

12.6.2 Sobre o Grupo de Conexões Global

O Grupo de Conexões Global é criado automaticamente quando um novo banco de dados é provisionado.

O Grupo de Conexões Global compreende o seguinte:
  • Definição do Recurso de Computação - Um Recurso de Computação está associado ao PDB (Banco de Dados Plugável). Depois que um novo PDB é provisionado, um Recurso de Computação é adicionado ao PDB. Um tenant pode provisionar mais de um PDB e, para cada PDB, um Recurso de Computação é adicionado. As definições no Recurso de Computação são relevantes para seu próprio PDB. O Recurso de Computação está associado a uma Oracle Wallet. A wallet Oracle contém as credenciais para estabelecer conexão com o PDB do usuário.

    Observação:

    A definição do Recurso de Computação só pode ser editada pelo Administrador.
  • Definição do Grupo de Conexões - O Grupo de Conexões Global compreende uma única conexão do tipo Global. Apenas um Grupo de Conexões Global para cada Recurso de Computação é permitido por PDB. Nenhuma senha é necessária para esta conexão, pois ela usa a Wallet que contém as credenciais do PDB. A Wallet está associada ao Recurso de Computação.

    Observação:

    Um Grupo de Conexões Global só pode ser editado pelo Administrador.

    Redefinir: Para redefinir a conexão do interpretador, clique no nome do grupo de conexões. O grupo de conexões é aberto em uma página separada, listando todas as conexões do interpretador no grupo. Selecione a conexão que você deseja redefinir e clique em Reset. Quando você clica em Redefinir, todas as conexões suportadas pelo interpretador são fechadas e todos os notebooks que usam essa conexão são cancelados.

    Observação:

    A opção Redefinir só está disponível para o Administrador.

Tópico principal: Conceitos Básicos dos Grupos de Conexões

12.6.3 Editar Conexão do Oracle Database Interpreter

Ao definir uma conexão de interpretador do Oracle Database, uma referência a um recurso de computação é criada. Esta referência contém todas as informações relacionadas à conexão sobre o interpretador.

Os Recursos de Computação de um interpretador do Oracle Database são definidos pelo seu serviço. É possível editar:

Observação:

Você deve ter a atribuição Administrador para editar esses campos.
  1. Nome: Você pode editar o nome do editor do interpretador aqui. Isso é útil se você tiver várias definições do mesmo tipo de interpretador no mesmo conjunto de interpretadores. Especificando um nome, você pode ativar ou desativar a vinculação específica a um notebook.
  2. Tipo: Este é um campo não editável. Indica o tipo de conexão
  3. Modo de Vinculação: Este campo não é editável. Ele define o comportamento da instância do interpretador na memória e como os recursos são compartilhados. Por padrão, o Modo de Vinculação do Grupo de Conexões Global é definido como Escopo. Isso garante que cada notebook crie uma nova instância de interpretador no mesmo processo de interpretador.
  4. Limite de Renderização de Linha: Determina o número de linhas a serem exibidas nos resultados do parágrafo ao extrair uma estrutura de dados que pode ser apresentada como uma tabela ou gráfico usando o serviço de plotagem incorporado do Zeppelin. Você deve considerar os recursos do navegador ao modificar essa configuração. O limite padrão é 1000.

    Observação:

    O serviço de plotagem do Zeppelin funciona com dados que são extraídos anteriormente para o lado do cliente para uma interface de usuário snapper.
  5. Comentários: Especifique qualquer informação relacionada ao interpretador que não exceda 1000 caracteres.

    Observação:

    Você deve ter a atribuição Administrador para editar este campo.
  6. Na seção Recurso de Computação, o campo Recursos indica a prioridade do recurso de computação. Este campo não pode ser editado.
  7. Na seção Banco de Dados, você pode especificar definições adicionais relacionadas à saída do DBMS PL/SQL. Selecione Ativado para permitir que o interpretador PL/SQL exiba as mensagens enviadas para DBMS_OUTPUT nos resultados do parágrafo.
  8. Clique em Salvar.

Tópico principal: Conceitos Básicos dos Grupos de Conexões

12.7 Conceitos Básicos das Sessões de Notebook

A página Sessões de Notebook fornece uma visão geral dos seus notebooks e permite gerenciar sessões de notebook do seu espaço de trabalho ou em espaços de trabalho nos quais você tem direitos de colaboração.

Na página Sessões de Notebooks, você descarrega e cancela sessões de notebook. É possível executar estas tarefas:

  • Stop: selecione o notebook que está em execução e clique em Stop. Isso interrompe o notebook selecionado no servidor.

  • Descarregar: Selecione o notebook carregado e clique em Descarregar. Isso remove o notebook selecionado da memória no servidor.

A página Sessões de Notebook exibe as seguintes informações sobre seus notebooks:

  • Notebook: O nome do notebook.

  • Projeto: O projeto no qual o notebook reside.

  • Espaço de trabalho: O espaço de trabalho no qual o projeto está disponível.

  • Conexão: O nome da conexão.

  • Proprietário: O proprietário do notebook.

  • Status: Os status de um notebook são:

    • Carregado: Indica que o notebook está carregado, mas não está vinculado ao websocket ou em execução.

    • Ativo: Indica que o notebook está vinculado ao websocket, mas não está em execução.

    • Em Execução: Indica que o parágrafo de notebook está na fila para execução ou está em execução.

Tópico principal: Administrar o Oracle Machine Learning