ALTER LISTING¶

Sintaxe¶

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'

Parâmetros¶

name

Especifica o identificador (nome) da listagem que está sendo alterada.

yaml_manifest_string

Especifica o manifesto no formato YAML para a listagem. Para obter informações e exemplos de arquivos de manifesto de listagem, consulte Listagem de referência de manifesto.

Os manifestos normalmente são fornecidos como cadeias de caracteres entre aspas de cifrão. Para obter mais informações, consulte Constantes de cadeias de caracteres entre aspas de cifrão.

RENAME TO new_name

Especifica o novo identificador para a listagem, que deve ser exclusivo. O novo identificador não pode ser usado se o identificador já estiver em vigor para uma listagem diferente.

{ PUBLISH | UNPUBLISH }

Especifica a ação a ser executada na listagem:

• PUBLISH Transforma uma listagem que não pode ser descoberta em uma listagem que pode ser descoberta.

  Especificar PUBLISH em uma listagem publicada anteriormente não tem efeito.

• UNPUBLISH Transforma uma listagem que pode ser descoberta em uma listagem que não pode ser descoberta por novos consumidores. Os consumidores existentes podem continuar acessando os dados associados a uma listagem não publicada.

  Especificar UNPUBLISH em uma listagem não publicada anteriormente não tem efeito.

Consulte também Cancelamento da publicação de uma listagem.

SET ...

Especifica uma (ou mais) propriedades a serem definidas para a listagem (separadas por espaços em branco, vírgulas ou novas linhas).

COMMENT = 'string_literal'

Adiciona um comentário ou substitui o comentário existente de uma listagem existente.

PUBLISH = { TRUE | FALSE }

Especifica como a listagem deve ser publicada.

Se TRUE, a listagem é publicada imediatamente na listagem do Marketplace Ops para revisão.

Padrão: TRUE.

REVIEW =  { TRUE | FALSE }

Especifica se a listagem deve ou não ser enviada para revisão no Marketplace Ops.

Padrão: TRUE.

Diferentes combinações de valores para as propriedades PUBLISH e REVIEW resultam nos seguintes comportamentos:

Notas de uso¶

• As listagens podem ser renomeadas somente no estado DRAFT.

• Ao definir a versão ativa do manifesto do formato YAML para uma listagem, você deve usar COMMIT para aplicar as alterações ou ABORT para descartar as alterações.

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter no mínimo os seguintes privilégios:

Se estiver usando o comando ALTER para modificar o conteúdo do manifesto para o preenchimento automático, você deverá usar uma função com os privilégios delegados necessários para configurar o preenchimento automático entre nuvens. Consulte Como permitir que as contas configurem o preenchimento automático entre nuvens.

Operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema primários.

Para obter instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de uma função personalizada.

Para informações gerais sobre concessões de funções e privilégios para executar ações SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplos¶

Altera a listagem MYLISTING para usar um arquivo de manifesto atualizado:

ALTER LISTING MYLISTING
AS
  $$
  title: "MyListing"
  subtitle: "Subtitle for MyListing"
  description: "Description or MyListing"
  listing_terms:
    type: "STANDARD"
  targets:
    accounts: ["Org1.Account1"]
  usage_examples:
     - title: "this is a test sql"
       description: "Simple example"
       query: "select *"
  $$

Copy

Altera a listagem MYLISTING ao publicá-la:

ALTER LISTING MYLISTING PUBLISH;

Copy

Altera a listagem MYLISTING ao cancelar sua publicação:

ALTER LISTING MYLISTING UNPUBLISH;

Copy

Altera a listagem MYLISTING ao definir um novo comentário:

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';

Copy