ALTER LISTING

Modifica as propriedades de uma listagem.

Consulte também:

CREATE LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, Listagem de referência de manifesto

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>'
Copy

Parâmetros

name

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

yaml_manifest_string

Especifica o manifesto no formato YAML para a listagem. Consulte Listagem de referência de manifesto para obter detalhes e exemplos de arquivos de manifesto de listagem.

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:

PUBLISH

REVIEW

Comportamento

TRUE

TRUE

Solicite uma revisão e publique imediatamente após a revisão.

TRUE

FALSE

Resulta em um erro. Você não pode publicar uma listagem no Snowflake Marketplace sem revisão.

FALSE

TRUE

Solicite uma revisão sem publicar automaticamente após a revisão.

FALSE

FALSE

Salve sua listagem como rascunho sem solicitar revisão ou publicação.

Notas de uso

  • Somente rascunhos ou listagens não publicadas podem ser renomeados.

Requisitos de controle de acesso

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

Privilégios

Privilégio

Objeto

Notas

OWNERSHIP ou MODIFY

Sobre a listagem sendo modificada.

Privilégios delegados para configurar o preenchimento automático entre nuvens.

Se o comando ALTER estiver modificando o conteúdo do manifesto para preenchimento automático

Consulte Como permitir que as contas configurem o preenchimento automático entre nuvens.

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

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

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

Alterar a listagem MY_LISTING 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

Alterar a listagem MYLISTING, publicando a listagem:

ALTER LISTING MYLISTING PUBLISH;
Copy

Alterar a listagem MYLISTING, cancelando a publicação da listagem.

ALTER LISTING MYLISTING UNPUBLISH;
Copy

Alterar a listagem MYLISTING, definindo um novo comentário:

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy
Linguagem: Português