Gerenciamento de Banco de Dados Plugável (PDB)

Esta seção abrange o gerenciamento de Bancos de Dados Plugáveis (PDBs) em um banco de dados contêiner (CDB). Inclui comandos para criação (dbaascli pdb create), exclusão (dbaascli pdb delete) e clonagem de PDBs (dbaascli pdb localClone, dbaascli pdb remoteClone). Você pode gerenciar estados do PDB com comandos para abrir, fechar ou devolver PDBs e recuperar detalhes da conexão (dbaascli pdb getConnectString). Comandos adicionais suportam backup, recuperação e realocação de PDBs, garantindo um controle abrangente sobre o ciclo de vida e as operações do PDB.

dbaascli pdb backup

Para fazer backup de um banco de dados plugável (PDB), consultar backups de PDB e excluir um backup de PDB, use o comando dbaascli pdb backup.

Pré-requisitos:

Sintaxe:

dbaascli pdb backup --pdbName <value> --dbname <value>
        {
            --start
                {
                    [--level1]
                    | [--archival --tag <value>]
                }
            | --delete --backupTag <value>
            | --status --uuid <value>
            | --getBackupReport --json <value> --tag <value>
            | --list [--json <value>]
        }

Parâmetros:

Parâmetro Atributos Descrição
--pdbName - Nome do PDB.
--dbname - Nome do Oracle AI Database.
--start | --delete | --status | --getBackupReport | --list - -
--start - Inicia o backup do PDB.
--start --level1 | --archival -
--start --level1 Cria um backup de Nível 1 (incremental).
--start --archival Cria um backup completo de arquivamento.
--start --archival → --tag Especifique a tag de backup.
--delete - Exclui backup de arquivamento.
--delete --backupTag Especifique a tag de backup a ser excluída.
--status - -
--status --uuid <value> -
--getBackupReport - Retorna relatório de backup.
--getBackupReport --json Especifique o nome do arquivo para saída JSON.
--getBackupReport --tag Especifique a tag de backup.
--list - Retorna informações sobre backup do PDB.
--list --json Especifique o nome do arquivo para saída JSON.

Perguntas Frequentes:

P: Qual é a finalidade do comando de backup dbaascli pdb?

R: O comando dbaascli pdb backup é usado para criar backups para um banco de dados plugável (PDB), consultar status de backup, gerar relatórios de backup e excluir backups do PDB em um ambiente do Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para usar o comando de backup dbaascli pdb?

R: O comando deve ser executado como usuário do root e você precisa estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Como inicio um backup do PDB usando o comando dbaascli PDB backup?

R: Você pode iniciar um backup do PDB usando a opção --start. Por exemplo:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start

P: Quais opções podem ser usadas com a bandeira –start?

A: Com o flag --start, você pode especificar:

P: Como crio um backup incremental do PDB de Nível 1?

R: Use o flag --level1 com a opção --start para criar um backup incremental de Nível 1:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --level1

P: Como crio um backup de PDB de arquivamento?

R: Use o flag --archival com a opção --start e especifique uma tag de backup usando --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --start --archival --tag <backup_tag>

P: Como excluo um backup específico do PDB?

R: Para excluir um backup específico, use o flag --delete e especifique a tag de backup usando --backupTag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --delete --backupTag <backup_tag>

P: Como posso verificar o status de um backup do PDB?

A: Use o flag --status junto com o --uuid de backup para verificar o status de um backup específico:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --status --uuid <backup_uuid>

P: Como recupero um relatório de backup do PDB no formato JSON?

R: Para obter um relatório de backup no formato JSON, use a opção --getBackupReport, especifique o nome do arquivo com --json e forneça a tag de backup com --tag:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --getBackupReport --json <file_name> --tag <backup_tag>

P: Como posso listar todos os backups do PDB para um PDB específico?

R: Use a opção --list para obter uma lista de todos os backups de um determinado PDB:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list

Opcionalmente, você pode gerar a lista no formato JSON usando o flag --json:

dbaascli pdb backup --pdbName <PDB_Name> --dbname <DB_Name> --list --json <file_name>

P: O que a opção –pdbName faz?

R: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja fazer backup, consultar ou excluir backups.

P: Qual é a finalidade da opção –dbname?

A: A opção --dbname especifica o nome do Oracle AI Database ao qual o PDB pertence.

P: Como especifico uma tag de backup para um backup do PDB?

R: Você especifica uma tag de backup usando a opção --tag ao iniciar um backup de arquivamento ou ao recuperar um relatório de backup:

--tag <backup_tag>

P: Posso executar backups do PDB no modo JSON?

R: Sim, as opções de relatório de backup (--getBackupReport) e listagem de backup (--list) suportam saída no formato JSON. Você especifica um nome de arquivo JSON usando a opção --json.

Exemplos:

dbaascli pdb bounce

Para devolver um banco de dados plugável (PDB), use o comando dbaascli pdb bounce.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb bounce
	{
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>]

Parâmetros:

Parâmetro Descrição
--pdbName especifica o nome da PDB
--pdbUID especifica o identificador do PDB
--dbname especifica o nome do banco e dados contêiner que hospeda o PDB
--openMode especifica o OPEN MODE de destino do PDB
--startServices especifica para iniciar todos os serviços ou uma lista de todos os serviços correspondentes a um PDB. Os valores aceitos são all ou uma lista de serviços de PDB delimitados por vírgulas.
--waitForCompletion especifica a execução da operação em primeiro plano ou em segundo plano. Valores válidos: true ou false.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb bounce?

R: O comando dbaascli pdb bounce é usado para fazer bounce (reiniciar) um banco de dados plugável (PDB) em um ambiente do Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb bounce?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Como faço para devolver um PDB especificando seu nome?

A: Para fazer bounce de um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como faço para devolver um PDB usando seu identificador exclusivo (UID)?

R: Para devolver um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb bounce --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Para que é usada a opção –dbname?

R: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que está sendo devolvido.

P: Para que é usada a opção –pdbName?

R: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja devolver.

P: Para que é usada a opção –pdbUID?

R: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja devolver.

P: Como especifico o modo de abertura de destino para o PDB ao devolvê-lo?

R: Você pode usar a opção --openMode para especificar o modo de abertura desejado para o PDB após a devolução. Os valores válidos são READ_WRITE e READ_ONLY. Por exemplo:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: Posso abrir o PDB no modo somente leitura após devolvê-lo?

R: Sim, você pode usar a opção --openMode READ_ONLY para abrir o PDB no modo somente leitura após a devolução:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_ONLY

P: Qual será o modo aberto padrão se –openMode não for especificado?

R: Se --openMode não for especificado, o PDB será aberto em seu modo de abertura padrão, que geralmente é READ_WRITE.

P: Posso usar –pdbName e –pdbUID no mesmo comando?

R: Não, você deve especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Como posso reiniciar um PDB e garantir que ele seja aberto no modo de leitura/gravação?

R: Para reiniciar um PDB e garantir que ele seja aberto no modo de leitura/gravação, use a opção --openMode READ_WRITE:

dbaascli pdb bounce --dbname <CDB_Name> --pdbName <PDB_Name> --openMode READ_WRITE

P: É obrigatório especificar o modo de abertura ao usar o comando dbaascli pdb bounce?

R: Não, a especificação do --openMode é opcional. Se não for fornecido, o PDB será aberto em seu modo padrão.

P: O que acontece se eu não especificar o flag –openMode?

R: Se o flag --openMode não for especificado, o PDB será aberto em seu modo padrão, que geralmente é READ_WRITE.

Exemplo: dbaascli pdb bounce

dbaascli pdb bounce --dbname cdb_name --pdbName pdb name associated with the CDB
dbaascli pdb bounce --dbname cdb_name --pdbUID con_uid of that pdb

Opcional:

dbaascli pdb close

Para fechar um banco de dados plugável (PDB), use o comando dbaascli pdb close.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb close
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--waitForCompletion <value>]

Parâmetros:

Parâmetro Descrição
--pdbname especifica o nome do PDB que você deseja fechar.
--pdbUID especifica o identificador do PDB
--dbname especifica o nome da base de dados contêiner que hospeda o PDB.
--waitForCompletion especifica a execução da operação em primeiro plano ou em segundo plano. Valores válidos: true ou false.

Após a conclusão bem-sucedida da execução desse comando, o PDB é fechado em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb close?

R: O comando dbaascli pdb close é usado para fechar um banco de dados plugável (PDB) em um ambiente do Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb close?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Como fecho um PDB especificando seu nome?

A: Para fechar um PDB especificando seu nome, use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como fecho um PDB especificando seu identificador exclusivo (UID)?

R: Para fechar um PDB usando seu identificador exclusivo (UID), use a seguinte sintaxe:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção –dbname faz no comando dbaascli pdb close?

R: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) que você deseja fechar.

P: O que a opção –pdbName faz no comando dbaascli pdb close?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja fechar.

P: Qual é a finalidade da opção –pdbUID no comando dbaascli pdb close?

R: A opção --pdbUID permite que você especifique o identificador exclusivo (UID) do banco de dados plugável (PDB) que deseja fechar.

P: Posso fechar o PDB em uma instância específica do CDB?

R: Não, após a conclusão bem-sucedida, o PDB é fechado em todas as instâncias do banco de dados de contêiner (CDB).

P: É possível especificar –pdbName e –pdbUID no mesmo comando?

R: Não, você pode especificar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: O que acontece quando o comando dbaascli pdb close é concluído com sucesso?

R: Quando o comando é concluído com sucesso, o PDB (banco de dados plugável) é fechado em todas as instâncias do CDB (banco de dados contêiner).

P: Como fecho um PDB específico em um CDB usando seu UID?

R: Você pode fechar um PDB específico usando seu UID executando:

dbaascli pdb close --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu esquecer de especificar –pdbName ou –pdbUID?

R: Você deve especificar --pdbName ou --pdbUID no comando. Se nenhum dos dois for fornecido, o comando não será executado.

P: Posso usar o comando dbaascli pdb close para um CDB diretamente?

R: Não, o comando foi projetado para fechar um banco de dados plugável (PDB) dentro de um banco de dados contêiner (CDB), não o próprio CDB.

Exemplo: dbaascli pdb close

dbaascli pdb close --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb

dbaascli pdb create

Para criar um novo banco de dados plugável (PDB), use o comando dbaascli pdb create.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb create --pdbName <value> --dbName <value> [--maxCPU <value>] [--maxSize <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--pdbTdeKeyVersionOCID <value>]

Parâmetros:

Parâmetro Atributos Descrição
--pdbName - especifica o nome do novo PDB que você deseja criar
--dbName - especifica o nome da base de dados contêiner que hospeda o novo PDB
--maxCPU - opcionalmente especifica o número máximo de CPUs que estão disponíveis para o PDB. A definição dessa opção é efetivamente o mesmo que definir o parâmetro CPU_COUNT no PDB
--maxSize - opcionalmente especifica o tamanho total máximo de arquivos de dados e arquivos temporários para tablespaces pertencentes ao PDB. A definição dessa opção é efetivamente o mesmo que definir a cláusula de armazenamento MAXSIZE PDB no comando SQL CREATE PLUGGABLE DATABASE. Você pode impor um limite especificando um número inteiro seguido de uma unidade de tamanho (K, M, G ou T), ou pode especificar UNLIMITED para impor explicitamente nenhum limite
--pdbAdminUserName - especifica o novo nome do usuário administrador do PDB
--lockPDBAdminAccount - especifica true ou false para bloquear a conta do usuário de administrador do PDB. O valor padrão é true.
--resume - retoma a execução anterior
--resume --sessionID especifica para retomar um ID da sessão específico
--executePrereqs - especifica yes para executar somente os pré-requisitos desta operação. Valores válidos: yes ou no
--waitForCompletion - especifica false para executar a operação no segundo plano. Valores válidos: true ou false
--blobLocation - local do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente DG.
--standbyBlobFromPrimary - especifica a localização do arquivo blob stand-by, que é preparado com base no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by. Observe que os parâmetrosblobLocation e standbyBlobFromPrimary são mutuamente exclusivos.
--pdbTdeKeyVersionOCID - O OCID da TDE.

Durante o processo de criação do PDB, você é solicitado a especificar a senha de administração do novo PDB.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb create?

R: O comando dbaascli pdb create é usado para criar um novo PDB (banco de dados plugável) em um CDB (banco de dados contêiner) em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb create?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: O que a opção –pdbName faz no comando dbaascli pdb create?

R: A opção --pdbName especifica o nome do novo banco de dados plugável (PDB) que você deseja criar.

P: O que a opção –dbName faz no comando dbaascli pdb create?

R: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospedará o novo banco de dados plugável (PDB).

P: Posso limitar os recursos da CPU para o novo PDB?

R: Sim, você pode usar a opção --maxCPU para especificar o número máximo de CPUs que o PDB pode usar. Isso é equivalente a definir o parâmetro CPU_COUNT no PDB.

P: Como posso limitar o tamanho do armazenamento de um PDB?

R: Você pode usar a opção --maxSize para especificar o tamanho total máximo de arquivos de dados e arquivos temporários para o PDB. Você pode definir um limite de tamanho (em K, M, G ou T) ou especificar UNLIMITED para nenhum limite.

P: Para que é usada a opção –pdbAdminUserName?

A: A opção --pdbAdminUserName especifica o nome do usuário administrador do novo PDB. Esse usuário terá privilégios administrativos no PDB.

P: É possível bloquear a conta do usuário administrador durante a criação do PDB?

R: Sim, você pode usar a opção --lockPDBAdminAccount para especificar se a conta de administrador do PDB deve ser bloqueada. O valor padrão é true (locked).

P: O que a opção –resume faz no comando dbaascli pdb create?

R: A opção --resume permite retomar um processo de criação de PDB com falha anterior.

P: Como eu especifico um ID de sessão para retomar uma execução anterior?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica do processo de criação do PDB.

P: Qual é a finalidade da opção –executePrereqs?

R: A opção --executePrereqs especifica se só serão executadas as verificações de pré-requisito para criação do PDB. É possível definir essa opção como yes ou no.

P: Posso executar o processo de criação do PDB em segundo plano?

R: Sim, você pode usar a opção --waitForCompletion e defini-la como falsa para executar a operação em segundo plano.

P: Para que é usada a opção –standbyBlobFromPrimary?

A: A opção --standbyBlobFromPrimary especifica o local do arquivo blob stand-by, que é preparado no banco de dados principal. Isto é necessário para operações PDB de banco de dados stand-by.

P: Como serei solicitado a informar a senha de administrador do PDB durante o processo de criação?

R: Durante o processo da criação do PDB, você será solicitado a especificar a senha de administração do novo PDB.

P: Posso criar um PDB stand-by usando o comando dbaascli PDB create?

R: Sim, se você estiver criando um PDB stand-by, poderá usar a opção --standbyBlobFromPrimary para especificar o local do arquivo blob stand-by no banco de dados principal.

P: O que acontece se eu não usar a opção –maxSize?

R: Se você não especificar a opção --maxSize, o PDB não terá um limite de tamanho de armazenamento, a menos que definido de outra forma pelas políticas do CDB.

P: O que acontece se eu não fornecer a opção –pdbAdminUserName?

R: Se você não fornecer a opção --pdbAdminUserName, o PDB será criado sem um usuário administrador especificado e você precisará configurar manualmente o usuário administrador após a criação.

P: Posso retomar uma criação de PDB com falha em algum momento do processo?

R: Sim, desde que a sessão não tenha sido encerrada, você poderá retomar uma criação de PDB com falha usando as opções --resume e --sessionID.

Exemplo: dbaascli pdb create

Para criar um PDB desde a constituição em um banco de dados padrão, em um ambiente que não seja do Data Guard:

dbaascli pdb create --dbName db721 --pdbName new_pdb1 --maxsize 5G --maxcpu 2

Para criar o PDB no ambiente do Data Guard:

dbaascli pdb create --dbName db721 --pdbName new_pdb1
dbaascli pdb create --dbName db721 --pdbName new_pdb1 --standbyBlobFromPrimary /tmp/send_db
721.tar

dbaascli pdb delete

Para excluir um banco de dados plugável (PDB), execute o comando dbaascli pdb delete.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb delete --dbName <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        [--executePrereqs] [--waitForCompletion <value>] [--resume [--sessionID <value>]] [--allStandbyPrepared] [--cleanupRelocatedPDB]

Parâmetros:

Parâmetro Descrição
--dbName especifica o nome do banco e dados contêiner que hospeda o PDB
--pdbName especifica o nome do PDB que você deseja excluir
--pdbUID especifica o UID do PDB que você deseja excluir
--executePrereqs especifica yes para executar somente os pré-requisitos desta operação. Valores válidos: yes ou no
--waitForCompletion especifica false para executar a operação no segundo plano. Valores válidos: true ou false
--resume especifica para retomar a execução anterior
--sessionID especifica para retomar um ID da sessão específico
--allStandbyPrepared especifica para confirmar se a operação foi executada com sucesso em todos os banco de dados stand-by
--cleanupRelocatedPDB especificar para limpar o banco de dados de origem após um PDB ser realocado

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb delete?

R: O comando dbaascli pdb delete é usado para excluir um PDB (banco de dados plugável) de um CDB (banco de dados contêiner) em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb delete?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: O que a opção –dbName especifica no comando dbaascli pdb delete?

R: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB que você deseja excluir.

P: Como posso especificar qual PDB excluir usando o comando dbaascli PDB delete?

R: Você pode especificar o PDB a ser excluído usando a opção --pdbName (especifica o nome do PDB) ou a opção --pdbUID (especifica o UID do PDB).

P: Posso executar as verificações de pré-requisitos sem realmente excluir o PDB?

R: Sim, você pode usar a opção --executePrereqs e defini-la como yes para executar apenas as verificações de pré-requisito da operação de exclusão do PDB.

P: Como posso executar o processo de exclusão do PDB em segundo plano?

R: Use a opção --waitForCompletion e defina-a como false para executar o processo de exclusão em segundo plano.

P: O que a opção –resume faz no comando dbaascli pdb delete?

R: A opção --resume permite retomar um processo de exclusão do PDB com falha anterior.

P: Como retomar uma sessão específica para exclusão de um PDB?

R: Você pode especificar um ID de sessão usando a opção --sessionID para retomar uma sessão específica para o processo de exclusão do PDB.

P: O que a opção –allStandbyPrepared faz?

R: A opção --allStandbyPrepared é usada para confirmar se a operação de exclusão foi executada com sucesso em todos os bancos de dados stand-by antes de continuar com a exclusão do PDB principal.

P: Qual é a finalidade da opção –cleanupRelocatedPDB?

R: A opção --cleanupRelocatedPDB limpa o banco de dados de origem após a realocação de um PDB, garantindo que nenhum resíduo seja deixado após a realocação.

P: Posso excluir um PDB que já foi realocado?

R: Sim, você pode usar a opção --cleanupRelocatedPDB para excluir um PDB que já foi realocado para um novo CDB.

P: Como garanto que a operação de exclusão seja executada com sucesso em bancos de dados stand-by?

R: Use a opção --allStandbyPrepared para confirmar se a operação foi executada com sucesso em todos os bancos de dados stand-by antes de continuar.

P: O que acontece se o processo de exclusão falhar e precisar ser retomado?

R: Você pode retomar o processo de exclusão usando a opção --resume e, se necessário, especificar o ID da sessão com --sessionID.

P: O que a definição –waitForCompletion para false faz?

R: A definição de --waitForCompletion como false permite que o processo de exclusão seja executado em segundo plano, permitindo que você continue trabalhando sem aguardar a conclusão da operação.

Exemplo: dbaascli pdb delete

Para excluir um PDB de um banco de dados padrão em um ambiente que não seja do Data Guard ou do banco de dados Stand-by no ambiente do Data Guard.

dbaascli pdb delete --dbName db721 --pdbName pdb1

Para criar o PDB do banco de dados Principal no ambiente do Data Guard:

dbaascli pdb create --dbName db721 --pdbName pdb1 --allStandbyPrepared

dbaascli pdb getConnectString

Para exibir informações da string de conexão do Oracle Net para um banco de dados plugável (PDB), execute o comando dbaascli pdb getConnectString.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb getConnectString --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }

Parâmetros:

Parâmetro Descrição
--dbname especifica o nome do banco e dados contêiner que hospeda o PDB
--pdbname especifica o nome do PDB para o qual deseja exibir informações de sequência de conexão
--pdbUID especifica o identificador do PDB

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb getConnectString?

R: O comando dbaascli pdb getConnectString é usado para exibir as informações da string de conexão do Oracle Net para um banco de dados plugável (PDB) em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli pdb getConnectString?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Como recupero a string de conexão de um PDB especificando seu nome?

R: Para recuperar a string de conexão especificando o nome do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como recupero a string de conexão de um PDB especificando seu identificador exclusivo (UID)?

R: Para recuperar a string de conexão usando o identificador exclusivo (UID) do PDB, use a seguinte sintaxe:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que a opção –dbname faz no comando dbaascli pdb getConnectString?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) para o qual você deseja exibir as informações da string de conexão.

P: O que a opção –pdbName faz no comando dbaascli pdb getConnectString?

R: A opção --pdbName especifica o nome do banco de dados plugável (PDB) para o qual você deseja recuperar as informações da string de conexão do Oracle Net.

P: Qual é a finalidade da opção –pdbUID no comando dbaascli pdb getConnectString?

R: A opção --pdbUID permite que você especifique o identificador exclusivo (UID) do banco de dados plugável (PDB) para o qual deseja exibir a string de conexão.

P: Posso usar –pdbName e –pdbUID no mesmo comando?

R: Não, você pode usar --pdbName ou --pdbUID, mas não ambos no mesmo comando.

P: Que tipo de informação é retornada pelo comando dbaascli pdb getConnectString?

R: O comando retorna as informações da string de conexão do Oracle Net para o PDB (banco de dados plugável) especificado.

P: Posso recuperar a string de conexão de um PDB em uma instância específica do banco de dados contêiner?

R: Não, a string de conexão é para o PDB como um todo, não para uma instância específica do banco de dados contêiner.

P: Como posso obter as informações da string de conexão se souber apenas o identificador exclusivo (UID) do PDB?

R: Você pode recuperar a string de conexão usando o UID do PDB executando:

dbaascli pdb getConnectString --dbname <CDB_Name> --pdbUID <PDB_UID>

P: O que acontece se eu não fornecer –pdbName ou –pdbUID?

R: Você deve especificar --pdbName ou --pdbUID para recuperar a string de conexão. O comando não será executado sem uma destas opções.

P: As informações da string de conexão do PDB são sempre as mesmas em todas as instâncias do CDB?

R: Sim, as informações da string de conexão são consistentes para o PDB em todas as instâncias do banco de dados contêiner (CDB).

Exemplo: dbaascli pdb getConnectString

dbaascli pdb getConnectString --dbname dbname --pdbName pdbName

dbaascli pdb getDetails

Para exibir detalhes de um banco de dados plugável (PDB), use o comando dbaascli pdb getDetails.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb getDetails --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }

Parâmetros:

Parâmetro Descrição
--dbname especifica o nome do banco e dados contêiner que hospeda o PDB
--pdbname especifica o nome do PDB que você deseja excluir
--pdbUID especifica o identificador do PDB

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb getDetails?

R: O comando dbaascli pdb getDetails é usado para exibir detalhes de um PDB (banco de dados plugável) hospedado em um CDB (banco de dados contêiner) em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb getDetails?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: O que a opção –dbname especifica no comando dbaascli pdb getDetails?

R: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB cujos detalhes você deseja exibir.

P: Como você especifica o PDB cujos detalhes deseja exibir?

R: Você pode especificar o PDB usando a opção --pdbName (para fornecer o nome do PDB) ou a opção --pdbUID (para fornecer o UID do PDB).

P: Qual é a diferença entre –pdbName e –pdbUID?

R: A opção --pdbName usa o nome do PDB para extrair detalhes, enquanto a opção --pdbUID usa o identificador exclusivo (UID) do PDB para extrair seus detalhes.

P: Posso usar –pdbName e –pdbUID juntos no comando dbaascli pdb getDetails?

R: Não, você pode especificar a opção --pdbName ou --pdbUID para obter detalhes do PDB, mas não os dois ao mesmo tempo.

P: Quais são alguns casos de uso do comando dbaascli pdb getDetails?

R: Você pode usar o comando dbaascli pdb getDetails para:

P: Como posso exibir detalhes de um PDB com base em seu nome?

R: Para exibir detalhes de um PDB com base em seu nome, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbName <PDB_Name>

P: Como posso exibir detalhes de um PDB com base em seu UID?

R: Para exibir detalhes de um PDB com base em seu UID, use a seguinte sintaxe:

dbaascli pdb getDetails --dbname <CDB_Name> --pdbUID <PDB_UID>

P: Este comando pode ser usado para vários PDBs em uma execução?

R: Não, o comando pode ser usado para extrair detalhes de um PDB por vez, especificando seu nome ou UID.

Exemplo: dbaascli pdb getDetails

dbaascli pdb getDetails--dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb getDetails--dbname cdb name --pdbUID con_uid of that pdb

dbaascli pdb list

Para exibir a lista de bancos de dados plugáveis (PDB) em um banco de dados contêiner, use o comando dbaascli pdb list.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb list --dbname

Parâmetros:

Parâmetro Descrição
--dbname especifica o nome do banco e dados contêiner que hospeda o PDB

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb list?

R: O comando dbaascli pdb list é usado para exibir a lista de bancos de dados plugáveis (PDBs) em um CDB (banco de dados contêiner) especificado em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb list?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: O que a opção –dbname especifica no comando dbaascli pdb list?

R: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda os bancos de dados plugáveis (PDBs) para os quais você deseja exibir a lista.

P: Posso exibir a lista de PDBs de vários bancos de dados contêineres de uma só vez?

R: Não, o comando dbaascli pdb list permite listar os PDBs de apenas um banco de dados contêiner (CDB) por vez, especificado pela opção --dbname.

P: Como listo os PDBs em um CDB (banco de dados contêiner) específico?

R: Você pode listar os PDBs em um CDB específico usando a seguinte sintaxe:

dbaascli pdb list --dbname <CDB_Name>

P: Quais informações são exibidas ao usar o comando dbaascli pdb list?

R: O comando retorna uma lista de todos os bancos de dados plugáveis (PDBs) dentro do banco de dados contêiner (CDB) especificado. A lista geralmente inclui os nomes dos PDBs e possivelmente outros detalhes como seu status.

P: Posso filtrar a lista de PDBs usando opções adicionais?

R: Não, o comando dbaascli pdb list não suporta opções de filtragem adicionais. Ele simplesmente retorna a lista completa de PDBs no CDB especificado.

P: O que acontece se o –dbname especificado não existir ou estiver incorreto?

R: Se o --dbname especificado estiver incorreto ou não existir, o comando retornará um erro e nenhuma lista de PDB será exibida.

P: O comando dbaascli pdb list pode ser usado para qualquer ambiente do Oracle AI Database?

R: Não, o comando dbaascli pdb list foi projetado especificamente para uso nos ambientes do Oracle Base Database Cloud@Customer.

Exemplo: lista de pdb dbaascli

dbaascli pdb list --dbname cdb name

dbaascli pdb localClone

Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, no mesmo banco de dados contêiner (CDB), use o comando dbaascli pdb localClone.

Pré-requisitos:

Execute o comando como usuário oracle.

Sintaxe:

dbaascli pdb localClone --pdbName <value> --dbName <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>]
    {
      [--blobLocation <value>]
      | [--standbyBlobFromPrimary <value>]
    }
    [--excludeUserTablespaces <value>] [--excludePDBData <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--sourcePDBServiceConvertList <value>]
    {
      [--createFromSnapshot
        {
          --snapshotName <value>
          | --snapshotUID <value>
        }
        [--copyDataFiles]]
      | [--snapshot]
    }

Parâmetros:

Parâmetro Atributos Descrição
--pdbName - especifica o nome do novo PDB que você deseja clonar
--dbName - especifica o nome da base de dados
--targetPDBName - especifica a nome do PDB de destino (novo PDB clonado)
--powerLimit - especifica o grau de paralelismo a ser usado para a operação do clone. O valor válido fica entre 1 e 128
--maxCPU - especifica o número máximo de CPUs a serem alocadas para o PDB
--maxSize - especifica o tamanho máximo de armazenamento em GB para o novo PDB
--resume - retoma a execução anterior
--resume --sessionID especifica para retomar um ID da sessão específico
--executePrereqs - especifica yes para executar somente os pré-requisitos desta operação. Valores válidos: yes ou no
--waitForCompletion - especifica false para executar a operação no segundo plano. Valores válidos: true ou false
--blobLocation - local do diretório personalizado em que o arquivo blob stand-by será gerado em um ambiente DG.
--standbyBlobFromPrimary - especifica o local do arquivo blob stand-by que está preparado com base no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by. Observe que os parâmetros --blobLocation e --standbyBlobFromPrimary se excluem mutuamente.
--excludeUserTablespaces - opção para ignorar espaços de tabela do usuário, por exemplo t1,t2,t3.
--excludePDBData - especificar true/yes para ignorar dados do usuário do PDB de origem.
--pdbAdminUserName - especificar o novo nome do usuário administrador do PDB.
--lockPDBAdminAccount - especifique true ou false para bloquear a conta do usuário de administrador do PDB. O valor padrão é true.
--sourcePDBServiceConvertList - especificar uma lista delimitada por vírgulas de nomes de serviço de origem para destino que precisam ser convertidos. A sintaxe é source_srv1:new_srv1,source_srv2:new_srv2.
--createFromSnapshot | --snapshot - -
--createFromSnapshot - especificar para criar o PDB com base no snapshot do PDB
--createFromSnapshot --snapshotName | --snapshotUID -
--createFromSnapshot --snapshotName especifique o nome do snapshot para criar o PDB com base no PDB.
--createFromSnapshot --snapshotUID especifique o UID do snapshot para criar o PDB com base no PDB.
--createFromSnapshot --copyDataFiles especifique esta opção para ignorar a cópia do snapshot.
--snapshot - especifique para criar o PDB com cópia de snapshot.

O PDB recém-clonado herda senhas de administração do PDB de origem.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb localClone?

R: O comando dbaascli pdb localClone é usado para criar um novo banco de dados plugável (PDB) como um clone de um PDB existente no mesmo banco de dados contêiner (CDB) em um ambiente do Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para executar o comando dbaascli pdb localClone?

R: O comando deve ser executado como usuário do oracle e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer. Além disso, o PDB de origem já deve existir no CDB especificado.

P: O que a opção –dbName especifica no comando dbaascli pdb localClone?

R: A opção --dbName especifica o nome do banco de dados contêiner (CDB) que hospeda o PDB de origem do qual o novo PDB será clonado.

P: O que a opção –pdbName especifica no comando dbaascli pdb localClone?

R: A opção --pdbName especifica o nome do novo PDB que você deseja criar como um clone do PDB existente no mesmo CDB.

P: Posso clonar um PDB com outro nome usando o comando dbaascli PDB localClone?

R: Sim, você pode especificar outro nome para o PDB clonado usando a opção --targetPDBName. Se essa opção não for fornecida, o PDB clonado herdará o nome do PDB de origem.

P: O que a opção –resume faz no comando dbaascli pdb localClone?

R: A opção --resume permite retomar uma operação de clonagem do PDB interrompida anteriormente.

P: Como eu limite os recursos de CPU disponíveis para o PDB clonado?

R: Você pode limitar os recursos da CPU para o PDB clonado usando a opção --maxCPU, que especifica o número máximo de CPUs que serão alocadas para o novo PDB.

P: Posso executar a operação de clonagem do PDB em segundo plano?

R: Sim, você pode executar a operação em segundo plano definindo a opção --waitForCompletion como false. Se você defini-lo como true, a operação será executada em primeiro plano e aguardará a conclusão.

P: Qual é a finalidade da opção –maxSize no comando dbaascli pdb localClone?

R: A opção --maxSize especifica o tamanho máximo de armazenamento (em GB) para o PDB recém-clonado. Se nenhum tamanho for especificado, o PDB clonado herdará os mesmos limites de armazenamento do PDB de origem.

P: Posso controlar o paralelismo da operação de clonagem do PDB?

R: Sim, você pode controlar o grau de paralelismo para a operação de clonagem usando a opção --powerLimit. Esta opção aceita valores entre 1 e 128 para definir o grau de paralelismo.

P: Para que é usada a opção –primaryDBWalletTar?

A: A opção --primaryDBWalletTar especifica a localização do arquivo tar da wallet do banco de dados principal. Essa opção só será necessária se a operação de clonagem envolver operações do PDB do banco de dados stand-by.

P: Posso executar somente as verificações de pré-requisitos para a operação de clonagem?

R: Sim, você só pode executar as verificações de pré-requisito usando a opção --executePrereqs e definindo-a como yes. Os valores inválidos são yes e no.

P: O que acontece se a operação de clonagem do PDB falhar ou for interrompida?

R: Se a operação de clonagem falhar ou for interrompida, você poderá retomá-la usando a opção --resume para continuar de onde a operação foi interrompida.

Exemplo: dbaascli pdb localClone

dbaascli pdb localClone --dbName db35 --pdbName PDB35 --targetPDBName local_clone1 --maxCPU 2 --maxSize 15

dbaascli pdb open

Para abrir um banco de dados plugável (PDB), use o comando dbaascli pdb open.

Execute o comando como usuário root ou oracle.

Sintaxe:

dbaascli pdb open
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        --dbname <value> [--openMode <value>] [--startServices <value>] [--waitForCompletion <value>] [--setPDBRefreshModeNone [--skipPDBRefresh] [--pdbAdminUserName <value>]] [--executePrereqs] [--resume [--sessionID <value>]] [--blobLocation <value>]

Parâmetros:

Parâmetro Descrição
--pdbName especifica o nome do PDB que você deseja abrir
--pdbUID especifica o identificador do PDB
--dbname especifica o nome da base de dados contêiner que hospeda o PDB.
--openMode especifica o MODE ABERTO de destino do PDB
--startServices especifica para iniciar todos ou listar todos os serviços correspondentes a um PDB. Os valores aceitos são all ou uma lista de serviços de PDB delimitados por vírgulas.
--waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos: true ou false
--setPDBRefreshModeNone especifica a conversão de um PDB atualizável em não atualizáveis
--skipPDBRefresh especifica para ignorar a atualização de PDB atualizável
--pdbAdminUserName especifica o novo nome de usuário de administrador do PDB
--executePrereqs especifica para executar as verificações de pré-requisito e reportar os resultados
--resume retoma a operação anterior
--sessionID especifica para retomar um ID da sessão específico
--blobLocation especifica o local de diretório personalizado no qual o arquivo blob stand-by será gerado em um ambiente Data Guard

Após a conclusão bem-sucedida, o PDB é aberto em todas as instâncias do banco de dados contêiner.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb open?

R: O comando dbaascli pdb open é usado para abrir um banco de dados plugável (PDB) em um banco de dados contêiner (CDB) Oracle em um ambiente Oracle Base Database Cloud@Customer.

P: Quem pode executar o comando dbaascli pdb open?

R: O comando pode ser executado como usuário root ou oracle.

P: O que a opção –pdbName especifica no comando dbaascli pdb open?

R: A opção --pdbName especifica o nome do PDB que você deseja abrir.

P: O que a opção –pdbUID especifica no comando dbaascli pdb open?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do PDB que você deseja abrir.

P: O que a opção –dbname especifica no comando dbaascli pdb open?

A: A opção --dbname especifica o nome do CDB (banco de dados de contêiner) que hospeda o PDB.

P: Qual é a finalidade da opção –openMode?

A: A opção --openMode especifica o modo no qual o PDB será aberto. Os valores válidos são READ_WRITE e READ_ONLY.

P: Posso iniciar serviços ao abrir o PDB?

R: Sim, você pode usar a opção --startServices para iniciar todos os serviços associados ao PDB especificando todos ou fornecer uma lista delimitada por vírgulas de serviços específicos a serem iniciados.

P: O que acontece se eu definir a opção –waitForCompletion como falsa?

R: Se --waitForCompletion estiver definido como false, o comando será executado em segundo plano e o usuário não precisará aguardar a conclusão da operação. Se definido como true, o comando aguardará a conclusão antes de sair.

P: O que a opção –setPDBRefreshModeNone faz?

R: A opção --setPDBRefreshModeNone converte um PDB atualizável (um que é atualizado regularmente de um banco de dados principal) em um PDB não atualizável.

P: Qual é a função da opção –skipPDBRefresh?

R: A opção --skipPDBRefresh permite que você ignore a operação de atualização ao abrir um PDB atualizável, impedindo que o PDB seja sincronizado com o banco de dados principal nesse momento.

P: O que a opção –pdbAdminUserName faz no comando dbaascli pdb open?

R: A opção --pdbAdminUserName permite especificar um novo nome de usuário administrador do PDB ao abrir o PDB.

P: O que acontece se o comando dbaascli pdb open for bem-sucedido?

R: Após a conclusão bem-sucedida, o PDB especificado será aberto em todas as instâncias do banco de dados contêiner (CDB).

P: É possível executar o comando dbaascli PDB open para um PDB atualizável?

R: Sim, o comando pode ser usado para PDBs atualizáveis. A opção --setPDBRefreshModeNone converte o PDB em não atualizável, e a opção --skipPDBRefresh ignora a operação de atualização durante o processo de abertura.

P: Qual será o modo de abertura padrão de um PDB se nenhuma –openMode for especificada?

R: Se nenhuma --openMode for especificada, o PDB geralmente será aberto no modo READ_WRITE por padrão.

Exemplo: dbaascli pdb open

dbaascli pdb open --dbname cdb name --pdbName pdb name associated with the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb

Opcional: --openMode READ_WRITE/READ_ONLY

dbaascli pdb recover

Para recuperar um banco de dados plugável (PDB), use o comando dbaascli pdb recover.

Pré-requisitos:

Sintaxe:

dbaascli pdb recover --dbname <value> --pdbName <value>
        {
            --start
                {
                    --untilTime <value> [--nonUTC]
                    | --untilSCN <value>
                    | --latest
                    | --tag <value>
                }
            | --status --uuid <value>
        }

Parâmetros:

Parâmetro Descrição
--dbname especifica o nome do banco e dados contêiner que hospeda o PDB
--pdbName especifica o nome do PDB que você deseja recuperar
--start inicia a recuperação de um PDB.
--untilTime recupera o PDB até o momento. Formato de entrada: DD-MON-YYYY HH24:MI:SS,
--untilSCN recupera o PDB até SCN
--latest recupera o PDB para o último estado conhecido
--tag recupera PDB para tag de arquivamento
--status exibe os detalhes sobre um processo da tarefa de recuperação do PDB
--uuid identificador exclusivo da operação de recuperação do PDB. Formato de entrada: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli pdb recovery?

R: O comando dbaascli pdb recover é usado para recuperar um banco de dados plugável (PDB) para um estado anterior usando backups armazenados em um destino de armazenamento de backup configurado.

P: Quem pode executar o comando de recuperação dbaascli pdb?

R: O comando deve ser executado como usuário do root.

P: O que é necessário antes de executar o comando dbaascli pdb recovery?

R: Antes de executar o comando, o banco de dados deve ser configurado com detalhes de destino do armazenamento de backup em que os backups são armazenados.

P: O que a opção –pdbName especifica no comando de recuperação dbaascli pdb?

A: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja recuperar.

P: O que a opção –dbname especifica no comando dbaascli pdb recovery?

A: A opção --dbname especifica o nome do Banco de Dados Contêiner (CDB) que hospeda o PDB.

P: Quais são as opções possíveis para iniciar uma recuperação de PDB usando a opção –start?

R: Você pode recuperar o PDB usando uma das seguintes opções:

P: Qual é o formato necessário para especificar a hora na opção –untilTime?

A: O horário deve estar no formato DD-MON-YYYY HH24:MI:SS.

P: Como posso recuperar um PDB para o estado mais recente usando a recuperação dbaascli PDB?

A: Para recuperar o PDB para o estado conhecido mais recente, use a opção --latest:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --latest

P: Como recupero um PDB para uma tag de arquivamento específica?

R: Você pode recuperar o PDB para uma tag específica usando a opção --tag:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --tag <tag_value>

P: Posso recuperar um PDB usando um SCN específico?

R: Sim, você pode recuperar o PDB para um SCN específico usando a opção --untilSCN:

dbaascli pdb recover --pdbName <value> --dbname <value> --start --untilSCN <SCN_value>

P: O que a opção –status faz no comando de recuperação dbaascli pdb?

A: A opção --status é usada para verificar o status de uma operação de recuperação. Você deve fornecer o --uuid para especificar a sessão de recuperação.

P: Como posso verificar o status de uma recuperação do PDB?

R: Para verificar o status de uma operação de recuperação, use a opção --status com o --uuid da sessão de recuperação:

dbaascli pdb recover --pdbName <value> --dbname <value> --status --uuid <uuid_value>

P: O que acontece se eu especificar a opção –latest no comando recovery?

R: Se você especificar a opção --latest, o PDB será recuperado para o estado mais recente disponível no backup.

Exemplos:

atualização do dbaascli pdb

Para atualizar um PDB (banco de dados plugável) especificado, use o comando dbaascli pdb refresh.

Execute o comando como usuário root ou oracle.

Sintaxe:

dbaascli pdb refresh --dbname <value>
        {
            --pdbName <value>
            | --pdbUID <value>
        }
        [--waitForCompletion <value>]

Parâmetros:

Parâmetro Descrição
--dbname especifica o nome do Oracle AI Database
--pdbName especifica o nome do banco de Dados Plugável
--pdbUID especifica o identificador do banco de Dados plugável
--waitForCompletion especifique false para executar a operação em segundo plano. Valores válidos: true ou false

Perguntas Frequentes:

P: Qual é a finalidade do comando de atualização dbaascli pdb?

R: O comando dbaascli pdb refresh é usado para atualizar um PDB (banco de dados plugável) especificado em um CDB (banco de dados contêiner).

P: Quem pode executar o comando de atualização dbaascli pdb?

A: O comando pode ser executado pelo usuário root ou oracle.

P: O que a opção –dbname especifica no comando de atualização dbaascli pdb?

A: A opção --dbname especifica o nome do banco de dados contêiner (CDB) que hospeda o banco de dados plugável (PDB) a ser atualizado.

P: O que a opção –pdbName especifica no comando de atualização dbaascli pdb?

R: A opção --pdbName especifica o nome do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção –pdbUID especifica no comando de atualização dbaascli pdb?

A: A opção --pdbUID especifica o identificador exclusivo (UID) do banco de dados plugável (PDB) que você deseja atualizar.

P: O que a opção –waitForCompletion faz no comando de atualização dbaascli pdb?

A: A opção --waitForCompletion especifica se a operação deve ser executada em primeiro plano ou em segundo plano. Se definido como verdadeiro, a operação será executada em primeiro plano e aguardará a conclusão. Se for definido como falso, a operação será executada no segundo plano.

P: Como posso atualizar um PDB e executar a operação em segundo plano?

R: Para atualizar um PDB e executar a operação em segundo plano, use a opção --waitForCompletion false:

dbaascli pdb refresh --dbname <value> --pdbName <value> --waitForCompletion false

P: Como atualizo um PDB usando seu identificador exclusivo (UID)?

A: Você pode atualizar o PDB usando a opção --pdbUID:

dbaascli pdb refresh --dbname <value> --pdbUID <value>

P: Posso especificar –pdbName e –pdbUID juntos no comando de atualização dbaascli pdb?

R: Não, ao atualizar um PDB, especifique --pdbName ou --pdbUID, mas não ambos.

P: O que acontece se eu não incluir a opção –waitForCompletion no comando?

R: Se você não especificar a opção --waitForCompletion, o comportamento padrão será aguardar a conclusão da operação antes de retornar o controle ao usuário.

P: Posso atualizar um PDB enquanto o banco de dados está em execução?

R: Sim, você pode atualizar um PDB enquanto o banco de dados estiver em execução, desde que o comando seja executado por um usuário com privilégios apropriados.

dbaascli pdb remoteClone

Para criar um novo banco de dados plugável (PDB) como clone de um PDB existente, em outro banco de dados contêiner (CDB), use o comando dbaascli pdb remoteClone.

Execute o comando como usuário root ou oracle.

Sintaxe:

dbaascli pdb remoteClone --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCPU <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--waitForCompletion <value>] [--sourcePDBExportedTDEKeyFile <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--excludeUserTablespaces <value>] [--excludePDBData <value>] [--pdbAdminUserName <value>] [--lockPDBAdminAccount <value>] [--sourcePDBServiceConvertList <value>] [--upgradePDB]
        {
            [--createFromSnapshot --snapshotName <value> [--copyDataFiles]]
            | [--snapshot]
        }
        [--refreshablePDB --refreshMode <value> [--refreshIntervalInMinutes <value>]] [--updateDBBlockCacheSize]
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }
        [--keepSourceDBServices <value>]

Parâmetros:

Parâmetro Atributos Descrição
--pdbName - especifica o nome do PDB da origem que você deseja clonar
--dbname - especifica o nome (DB_NAME) do CDB que hospeda o PDB recém-clonado
--sourceDBConnectionString - especifica a sequência de caracteres de conexão de banco de dados da origem no formato scan_name:scan_port/database_service_name
--targetPDBName - especifica a nome do PDB de destino (novo PDB clonado)
--powerLimit - especifica o grau de paralelismo a ser usado para a operação do clone. O valor válido fica entre 1 e 128
--maxCPU - especifica o número máximo de CPUs a serem alocadas para o PDB
--maxSize - especifica o tamanho máximo de armazenamento em GB para o novo PDB
--resume - retoma a execução anterior
--resume --sessionID especifica para retomar um ID da sessão específico
--executePrereqs - especifica yes para executar somente os pré-requisitos desta operação. Valores válidos: yes ou no
--waitForCompletion - especifica false para executar a operação no segundo plano. Valores válidos: true ou false
--sourcePDBExportedTDEKeyFile - especifica o arquivo da chave exportada do PDB da origem. Essa variável só se aplica ao banco de dados 12.1.
--blobLocation - especifica o caminho personalizado no qual o arquivo blob stand-by será gerado em um ambiente de Data Guard
--standbyBlobFromPrimary - especificar o local do arquivo blob stand-by, que está preparado com base no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by. Observe que os parâmetros --blobLocation e --standbyBlobFromPrimary se excluem mutuamente.
--excludeUserTablespaces - opção para ignorar espaços de tabela do usuário, exemplo t1,t2,t3.
--excludePDBData - especifique true/yes para ignorar os dados do usuário do PDB de origem.
--pdbAdminUserName - especifica o novo nome de usuário de administrador do PDB
--lockPDBAdminAccount - especifique true ou false para bloquear a conta do usuário de administrador do PDB. O valor padrão é true.
--sourcePDBServiceConvertList - especifique uma lista delimitada por vírgulas de nomes de serviço de origem para destino, que precisam ser convertidos. A sintaxe é source_srv1:new_srv1, source_srv2:new_srv2.
--upgradePDB - especificar para fazer upgrade do PDB como parte desta operação
--createFromSnapshot | --snapshot - -
--createFromSnapshot - especificar para criar o PDB com base no snapshot do PDB
--createFromSnapshot --snapshotName especifique o nome do snapshot para criar o PDB com base no PDB.
--createFromSnapshot --copyDataFiles especifique esta opção para ignorar a cópia do snapshot.
--snapshot - especifique para criar o PDB com cópia de snapshot.
--refreshablePDB - especifica a criação de PDB atualizável
--refreshablePDB --refreshMode especifica o modo de atualização do PDB atualizável. Valores válidos: AUTO ou MANUAL
--refreshablePDB --refreshMode → --refreshIntervalInMinutes especifica o intervalo de renovação para refreshablePDB em minutos
--refreshablePDB --dblinkUsername especifica o usuário comum de um Banco de Dados Remoto usado para o link do banco de dados para estabelecer conexão ao Banco de Dados Remoto
--refreshablePDB --dblinkUsername → --honorCaseSensitiveUserName indica se o nome de usuário especificado diferencia maiúsculas de minúsculas
--dbLinkName - especifica um nome de link de banco de dados existente no banco de dados de destino que aponta para o banco de dados remoto

Quando solicitado, forneça a senha do usuário SYS para o PDB de origem. O PDB recém-clonado herda senhas de administração do PDB de origem. O PDB clonado é nomeado usando o seguinte formato: dbname_sourcepdbname. Este comando é suportado somente para bancos que não estão em uma configuração de Data Guard e usam o Oracle AI Database versão 12.2.0.1 ou mais recente.

Perguntas Frequentes:

P: Para que é usado o comando dbaascli pdb remoteClone?

R: O comando dbaascli pdb remoteClone é usado para criar um novo Banco de Dados Plugável (PDB) como um clone de um PDB existente em outro CDB (banco de dados contêiner).

P: Qual usuário deve executar o comando dbaascli pdb remoteClone?

R: O comando deve ser executado como usuário root ou oracle.

P: O que é necessário quando solicitado durante a operação dbaascli pdb remoteClone?

R: Você deve fornecer a senha de usuário SYS para o PDB de origem.

P: O que o parâmetro –pdbName especifica?

R: O parâmetro --pdbName especifica o nome do PDB que você deseja clonar.

P: O que o parâmetro –dbName representa?

R: O parâmetro --dbName representa o nome (DB_NAME) do CDB que hospedará o PDB recém-clonado.

P: Como deve ser formatado o –sourceDBConnectionString?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: Qual é a finalidade do parâmetro –targetPDBName?

A: O parâmetro --targetPDBName especifica o nome do PDB recentemente clonado.

P: O que o controle –powerLimit?

A: O parâmetro --powerLimit controla o grau de paralelismo usado para a operação de clonagem. O valor válido fica entre 1 e 12.

P: O que o parâmetro –maxCPU define?

R: O parâmetro --maxCPU define o número máximo de CPUs a serem alocadas para o processo de clonagem do PDB.

P: Quais são as funções de –maxSize?

A: O parâmetro --maxSize especifica o tamanho máximo de armazenamento em GB para o novo PDB.

P: O que o parâmetro –resume faz?

A: O parâmetro --resume retoma a operação de clonagem anterior.

P: O que você deve fornecer com a opção –resume?

R: Você pode especificar uma --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o controle –executePrereqs?

R: O parâmetro --executePrereqs determina se somente os pré-requisitos para a operação de clonagem devem ser executados. Os valores válidos são yes ou no.

P: Como –waitForCompletion afeta a operação?

A: O parâmetro --waitForCompletion especifica se deve aguardar a conclusão da operação ou executá-la em segundo plano. Os valores válidos são true ou false.

P: O que é especificado pelo parâmetro –sourcePDBExportedTDEKeyFile?

A: O parâmetro --sourcePDBExportedTDEKeyFile especifica o arquivo de chaves exportado do PDB de origem. Esse parâmetro só se aplica ao Oracle Database versão 12.1.

P: O que o parâmetro –blobLocation define?

R: O parâmetro --blobLocation especifica o caminho personalizado no qual o arquivo BLOB stand-by será gerado em um ambiente Data Guard.

P: Quando é utilizado –standbyBlobFromPrimary?

A: O parâmetro --standbyBlobFromPrimary especifica o local do arquivo BLOB stand-by preparado no banco de dados principal. Isso só é necessário para operações de PDB do banco de dados stand-by.

P: É possível usar –blobLocation e –standbyBlobFromPrimary juntos?

R: Não, --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que a opção –excludeUserTablespaces faz?

R: A opção --excludeUserTablespaces permite que você ignore a clonagem de tablespaces específicos do usuário. Por exemplo, t1,t2,t3.

P: Qual é o efeito de –excludePDBData?

A: A opção --excludePDBData especifica se os dados do usuário devem ser ignorados do PDB de origem durante a clonagem. Os valores válidos são true ou yes.

P: O que é especificado por –pdbAdminUserName?

R: O parâmetro --pdbAdminUserName especifica o novo nome do usuário administrador para o PDB clonado.

P: O que a opção –lockPDBAdminAccount controla?

R: A opção --lockPDBAdminAccount especifica se a conta de usuário administrador do PDB deve ser bloqueada. O valor padrão é true.

P: O que –sourcePDBServiceConvertList especifica?

A: O parâmetro --sourcePDBServiceConvertList especifica uma lista delimitada por vírgulas de conversões de nome de serviço de origem para destino. Por exemplo, source_srv1:new_srv1,source_srv2:new_srv2.

P: Qual é a finalidade de –refreshablePDB?

A: O parâmetro --refreshablePDB especifica se um PDB atualizável deve ser criado.

P: O que o controle –refreshMode?

R: O parâmetro --refreshMode controla o modo de atualização de um PDB atualizável. Os valores válidos são AUTO ou MANUAL.

P: Como funciona o –refreshIntervalInMinutes?

R: O parâmetro --refreshIntervalInMinutes especifica o intervalo em minutos para atualizar o PDB atualizável.

P: Para que é utilizado o –dblinkUsername?

A: O parâmetro --dblinkUsername especifica o usuário comum de um Banco de Dados Remoto usado para o link do Banco de Dados para estabelecer conexão com o Banco de Dados Remoto.

P: O que a opção –honorCaseSensitiveUserName indica?

A: A opção --honorCaseSensitiveUserName indica que o nome de usuário especificado faz distinção entre maiúsculas e minúsculas.

P: Qual é o efeito de –updateDBBlockCacheSize?

R: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache do bloco do BD para suportar a cópia de dados com um tamanho diferente do bloco.

P: O que devo fazer se encontrar um erro com o comando dbaascli pdb remoteClone?

R: Revise a mensagem de erro para obter detalhes, certifique-se de que todos os parâmetros estejam especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Além disso, verifique se os bancos de dados de origem e de destino atendem a todos os requisitos.

P: E se eu esquecer a senha do usuário SYS do PDB de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS para o PDB de origem. Sem ele, a operação de clonagem não pode ser concluída.

Exemplo: dbaascli pdb remoteClone

dbaascli pdb remoteClone --sourceDBConnectionString test-can.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521 --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2
dbaascli pdb remoteClone --sourceDBConnectionString orcla.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com --pdbName source_pdb1 --dbName db9944 --targetPDBName new_pdb1 --maxsize 5 --maxcpu 2

dbaascli pdb relocate

Para realocar o PDB especificado do banco de dados remoto para o banco de dados local, use o comando dbaascli pdb relocate.

Pré-requisitos:

Execute o comando como usuário oracle. Quando solicitado, informe a senha do usuário SYS para o banco de dados de origem.

Sintaxe:

dbaascli pdb relocate --pdbName <value> --dbName <value> --sourceDBConnectionString <value> [--targetPDBName <value>] [--powerLimit <value>] [--maxCpu <value>] [--maxSize <value>] [--resume [--sessionID <value>]] [--executePrereqs] [--sourcePDBServices <value>] [--sourcePDBReadOnlyServices <value>] [--relocateAvailabilityType <value>] [--waitForCompletion <value>]
        {
            [--blobLocation <value>]
            | [--standbyBlobFromPrimary <value>]
        }
        [--upgradePDB] [--updateDBBlockCacheSize]
        {
            [--skipOpenPDB [--enableRefreshMode --refreshMode <value> [--refreshIntervalInMinutes <value>]]]
            | [--completePDBRelocate]
        }
        {
            [--dblinkUsername <value> [--honorCaseSensitiveUserName]]
            | [--dbLinkName <value>]
        }

Parâmetros:

Parâmetro Atributos Descrição
--pdbName - especifica o nome da origem do PDB a ser realocado
--dbName - especifica o nome do banco de dados de destino
--sourceDBConnectionString - especifica a sequência de caracteres de conexão de banco de dados da origem no formato <scan_name>:<scan_port>/<database_service_name>
--targetPDBName - especifica um nome para o PDB de destino (novo PDB realocado)
--powerLimit - especifica o grau de paralelismo a ser usado para a operação de realocação
--maxCpu - especifica o número máximo de CPUs a serem alocadas para o PDB
--maxSize - especifica o tamanho máximo de armazenamento em GB para o novo PDB
--resume - especifica para retomar a execução anterior
--resume --sessionID especifica para retomar um ID da sessão específico
--executePrereqs - especifica yes para executar somente os pré-requisitos desta operação. Valores válidos: yes ou no
--sourcePDBServices - especifica uma lista de serviços de PDB de origem delimitados pela vírgula
--sourcePDBReadOnlyServices - especifica uma lista delimitada por vírgulas de serviços somente para leitura de PDBs de origem
--relocateAvailabilityType - especifica a disponibilidade MAX ou NORMAL para ativar o encaminhamento de conexão do listener
--waitForCompletion - especifica false para executar a operação no segundo plano. Valores válidos: true ou false
--blobLocation - especifica um local de diretório personalizado no qual o arquivo blob stand-by será gerado em um ambiente DG.
--standbyBlobFromPrimary - especifica o local do arquivo BLOB stand-by, que é preparado com base no banco de dados principal. Isso só é necessário para operações stand-by.
--upgradePDB - especifique true para fazer upgrade do PDB como parte desta operação. Valores válidos: true ou false.
--updateDBBlockCachesize - especifica para ativar o aplicativo a fim de definir os parâmetros da inicialização do db block cache size para suportar a cópia dos dados com tamanho diferente de bloco
--skipOpenPDB - especifica que o PDB não deve ser aberto no final da operação atual.
--skipOpenPDB --enableRefreshMode especifica para ativar o suporte à atualização do PDB na etapa um de realocação do PDB.
--skipOpenPDB --enableRefreshMode → --refreshMode especifica o modo de atualização do PDB atualizável. Valores válidos: AUTO ou MANUAL
--skipOpenPDB --enableRefreshMode → --refreshMode → --refreshIntervalInMinutes especifica para atualizar o intervalo de refreshablePDB em minutos
--completePDBRelocate - especifica para concluir a realocação do PDB, se feita como uma operação de duas fases.

Perguntas Frequentes:

P: Para que é usado o comando dbaascli pdb relocate?

R: O comando dbaascli pdb relocate é usado para realocar um PDB (Banco de Dados Plugável) de um banco de dados remoto para um banco de dados local.

P: Qual usuário deve executar o comando dbaascli pdb relocate?

R: O comando deve ser executado como o usuário Oracle.

P: O que é necessário quando solicitado durante a operação de realocação do dbaascli pdb?

R: Você deve fornecer a senha de usuário SYS para o banco da dados de origem.

P: O que o parâmetro –pdbName especifica?

A: O parâmetro --pdbName especifica o nome do PDB de origem a ser realocado.

P: Qual é a finalidade do parâmetro –dbName?

R: O parâmetro --dbName especifica o nome do banco de dados de destino no qual o PDB será realocado.

P: Como deve ser formatado o –sourceDBConnectionString?

A: O --sourceDBConnectionString deve ser formatado como <scan_name>:<scan_port>/<database_service_name>.

P: O que o parâmetro –targetPDBName faz?

A: O parâmetro --targetPDBName especifica um novo nome para o PDB realocado.

P: Qual é o uso de –powerLimit?

A: O parâmetro --powerLimit especifica o grau de paralelismo a ser usado durante a operação de realocação.

P: Como –maxCpu afeta o processo de realocação?

A: O parâmetro --maxCpu especifica o número máximo de CPUs a serem alocadas para o processo de realocação do PDB.

P: O que o parâmetro –maxSize define?

R: O parâmetro --maxSize define o tamanho máximo de armazenamento em GB para o novo PDB.

P: Qual é a função de –resume?

A: O parâmetro --resume indica que a operação de realocação deve ser retomada de onde parou.

P: O que devo fornecer com a opção –resume?

R: Você pode especificar uma --sessionID para retomar uma sessão específica se estiver retomando uma operação anterior.

P: O que o parâmetro –executePrereqs faz?

R: O parâmetro --executePrereqs determina se somente os pré-requisitos para a operação devem ser executados. Os valores válidos são sim ou não.

P: O que é especificado pelo parâmetro –sourcePDBServices?

R: O parâmetro --sourcePDBServices especifica uma lista de serviços de PDB de origem delimitados pela vírgula.

P: O que a lista de parâmetros –sourcePDBReadOnlyServices faz?

R: O parâmetro --sourcePDBReadOnlyServices lista uma lista delimitada por vírgulas de serviços somente para leitura do PDB de origem.

P: Qual é o efeito de –waitForCompletion?

A: O parâmetro --waitForCompletion especifica se a operação deve ser executada em segundo plano. Os valores válidos são true ou false.

P: O que o parâmetro –blobLocation especifica?

R: O parâmetro --blobLocation especifica a localização de um diretório personalizado em que o arquivo BLOB stand-by será gerado em um ambiente Data Guard.

P: Quando devo usar –standbyBlobFromPrimary?

R: Use --standbyBlobFromPrimary para especificar a localização do arquivo BLOB stand-by, que é preparado com base no banco de dados principal. Isso só é necessário para operações stand-by.

P: Posso usar –blobLocation e –standbyBlobFromPrimary juntos?

R: Não, os parâmetros --blobLocation e --standbyBlobFromPrimary são mutuamente exclusivos e não podem ser usados juntos.

P: O que o –upgradePDB faz?

A: O parâmetro --upgradePDB especifica se será feito upgrade do PDB como parte da operação de realocação. Os valores válidos são true ou false.

P: Qual é a finalidade de –updateDBBlockCacheSize?

R: A opção --updateDBBlockCacheSize permite que o aplicativo defina os parâmetros de inicialização do tamanho do cache do bloco do BD para suportar a cópia de dados com um tamanho diferente do bloco.

P: O que a opção –skipOpenPDB faz?

R: A opção --skipOpenPDB indica que o PDB não deve ser aberto no final da operação de realocação.

P: Quando devo usar –completePDBRelocate?

R: Use --completePDBRelocate para concluir a realocação do PDB, se ela for feita como uma operação de duas fases.

P: O que devo fazer se encontrar um erro ao usar o comando dbaascli pdb relocate?

R: Verifique a mensagem de erro para obter detalhes, certifique-se de que todos os parâmetros estejam especificados corretamente e verifique se você tem as permissões e credenciais necessárias. Também pode ser necessário revisar os pré-requisitos e as configurações.

P: E se eu esquecer a senha do usuário SYS do banco de dados de origem?

R: Você precisará redefinir ou recuperar a senha do usuário SYS para o banco de dados de origem. Sem isso, você não pode concluir a operação de realocação.

Exemplo: dbaascli pdb relocate

dbaascli pdb relocate --sourceDBConnectionString test-scan.dbaastoolslrgsu.dbaastoolslrgvc.oraclevcn.com:1521/source_cdb_service_name --pdbName source_pdb --dbName target_db