
  



  
  <section id="common-setup-for-snowpark-container-services-tutorials">
<h1>Tutoriais de configuração comum para Snowpark Container Services<a class="headerlink" href="#common-setup-for-snowpark-container-services-tutorials" title="Link to this heading" data-nosnippet="">¶</a></h1>
<aside class="newfeat sidebar">
<p class="sidebar-title">Recurso <a class="image-small reference internal" href="../../../_images/logo-snowflake-black.png"><img alt="Logotipo do Snowflake em preto (sem texto)" class="image-small" src="../../../_images/logo-snowflake-black.png" style="width: 15px; height: 15px;"></a> — Geralmente disponível</p>
<p>Snowpark Container Services está disponível para contas em <a class="reference internal" href="../../../user-guide/intro-regions.html#label-na-general-regions"><span class="std std-ref">regiões comerciais da AWS, do Microsoft Azure e do Google Cloud Platform</span></a>, com algumas exceções. Para obter mais informações, consulte <a class="reference internal" href="../overview.html#label-snowpark-containers-overview-available-regions"><span class="std std-ref">Regiões disponíveis e considerações</span></a>.</p>
</aside>

<section id="introduction">
<h2>Introdução<a class="headerlink" href="#introduction" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>Este tópico fornece instruções para a configuração comum necessária para todos os tutoriais do Snowpark Container Services fornecidos nesta documentação.</p>
</section>
<section id="configure-prerequisites">
<h2>Configuração de pré-requisitos<a class="headerlink" href="#configure-prerequisites" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>Revise os seguintes pré-requisitos para garantir que você possa concluir os tutoriais:</p>
<ul class="simple">
<li><p><strong>Uma conta Snowflake:</strong> observe que contas de avaliação não são suportadas.</p></li>
<li><p><strong>SnowSQL, o cliente de linha de comando para executar comandos SQL (opcional):</strong> você pode usar qualquer cliente Snowflake que ofereça suporte à execução de comandos SQL e o upload de arquivos para um estágio Snowflake. Os tutoriais são testados usando as interfaces da web SnowSQL e <a class="reference internal" href="../../../user-guide/ui-snowsight-gs.html#label-snowsight-getting-started-sign-in"><span class="std std-ref">Snowsight</span></a>. Para obter instruções sobre como instalar esse cliente de linha de comando, consulte <a class="reference internal" href="../../../user-guide/snowsql-install-config"><span class="doc">Instalação do SnowSQL</span></a>.</p></li>
<li><p><strong>Docker Desktop:</strong> estes tutoriais fornecem instruções para usar o Docker Desktop. Para instruções de instalação, consulte <a class="reference external" href="https://docs.docker.com/get-docker/">https://docs.docker.com/get-docker/</a>.  Observe que você pode usar qualquer cliente compatível com OCI para criar imagens, como Docker, Podman ou Nerdctl.</p></li>
</ul>
</section>
<section id="create-snowflake-objects">
<span id="label-snowpark-containers-common-setup-create-objects"></span><h2>Criação de objetos Snowflake<a class="headerlink" href="#create-snowflake-objects" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>Execute o SQL fornecido usando SnowSQL ou Snowsight.</p>
<ol class="arabic">
<li><p>Faça o login no Snowflake como um usuário com a função ACCOUNTADMIN.</p></li>
<li><p>Usando a função ACCOUNTADMIN, execute o script a seguir, substituindo <code class="samp docutils literal notranslate"><em><span class="pre">user_name</span></em></code> pelo nome do usuário Snowflake que testará os tutoriais. Para esses tutoriais, você pode escolher o mesmo usuário que executa este script ou outro usuário em sua conta Snowflake. O script faz o seguinte:</p>
<ul class="simple">
<li><p>Cria uma função (<code class="docutils literal notranslate"><span class="pre">test_role</span></code>) e outros objetos Snowflake. Para criar a função e os objetos, você deve usar a função ACCOUNTADMIN. (Essa restrição ajuda a controlar custos e gerenciar riscos de informações comerciais.) O script também concede à função <code class="docutils literal notranslate"><span class="pre">test_role</span></code> os privilégios necessários para gerenciar os objetos recém-criados.</p></li>
<li><p>Concede a função ao usuário Snowflake especificado, que então usa a função para explorar os tutoriais.</p></li>
</ul>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">USE</span> <span class="ni">ROLE</span> <span class="ni">ACCOUNTADMIN</span><span class="p">;</span>

<span class="ni">CREATE</span> <span class="ni">ROLE</span> <span class="gi">test_role</span><span class="p">;</span>

<span class="ni">CREATE</span> <span class="ni">DATABASE</span> <span class="ni">IF</span> <span class="ni">NOT</span> <span class="ni">EXISTS</span> <span class="gi">tutorial_db</span><span class="p">;</span>
<span class="ni">GRANT</span> <span class="ni">OWNERSHIP</span> <span class="ni">ON</span> <span class="ni">DATABASE</span> <span class="gi">tutorial_db</span> <span class="ni">TO</span> <span class="ni">ROLE</span> <span class="gi">test_role</span> <span class="ni">COPY</span> <span class="ni">CURRENT</span> <span class="ni">GRANTS</span><span class="p">;</span>

<span class="ni">CREATE</span> <span class="ni">OR</span> <span class="ni">REPLACE</span> <span class="ni">WAREHOUSE</span> <span class="gi">tutorial_warehouse</span> <span class="ni">WITH</span>
  <span class="ni">WAREHOUSE_SIZE</span><span class="p">=</span><span class="nc">'X-SMALL'</span><span class="p">;</span>
<span class="ni">GRANT</span> <span class="ni">USAGE</span> <span class="ni">ON</span> <span class="ni">WAREHOUSE</span> <span class="gi">tutorial_warehouse</span> <span class="ni">TO</span> <span class="ni">ROLE</span> <span class="gi">test_role</span><span class="p">;</span>

<span class="ni">GRANT</span> <span class="ni">BIND SERVICE ENDPOINT</span> <span class="ni">ON</span> <span class="ni">ACCOUNT</span> <span class="ni">TO</span> <span class="ni">ROLE</span> <span class="gi">test_role</span><span class="p">;</span>

<span class="ni">CREATE</span> <span class="ni">COMPUTE POOL</span> <span class="gi">tutorial_compute_pool</span>
  <span class="ni">MIN_NODES</span> <span class="p">=</span> <span class="nf">1</span>
  <span class="ni">MAX_NODES</span> <span class="p">=</span> <span class="nf">1</span>
  <span class="ni">INSTANCE_FAMILY</span> <span class="p">=</span> <span class="gi">CPU_X64_XS</span><span class="p">;</span>
<span class="ni">GRANT</span> <span class="ni">USAGE</span><span class="p">,</span> <span class="ni">MONITOR</span> <span class="ni">ON</span> <span class="ni">COMPUTE POOL</span> <span class="gi">tutorial_compute_pool</span> <span class="ni">TO</span> <span class="ni">ROLE</span> <span class="gi">test_role</span><span class="p">;</span>

<span class="ni">GRANT</span> <span class="ni">ROLE</span> <span class="gi">test_role</span> <span class="ni">TO</span> <span class="ni">USER</span> <span class="p">&lt;</span><span class="ni">user_name</span><span class="p">&gt;</span>
</pre></div>
</div><div data-codeblock-index="0" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
<p>Note que:</p>
<ul class="simple">
<li><p>Você cria um warehouse porque os serviços (incluindo serviços de trabalho) podem executar instruções SQL DML (como SELECT e INSERT). Snowflake executa essas instruções no warehouse.</p></li>
<li><p>No tutorial 1, você cria um serviço que expõe um ponto de extremidade como público para permitir que os usuários acessem o serviço na web pública (entrada). Para criar este serviço:</p>
<ul>
<li><p>A função <code class="code docutils literal notranslate"><span class="pre">test_role</span></code> deve ter o privilégio BIND SERVICE ENDPOINT na conta:</p></li>
<li><p>A implementação atual requer uma integração de segurança criada pelo script.</p></li>
</ul>
</li>
<li><p>Um <a class="reference internal" href="../working-with-compute-pool"><span class="doc">pool de computação</span></a> é uma coleção de um ou mais nós de máquinas virtuais (VM) nos quais o Snowflake executa seus serviços.</p></li>
</ul>
</li>
<li><p>Certifique-se de estar conectado ao Snowflake como o usuário especificado no script anterior.</p></li>
<li><p>Usando a função <code class="code docutils literal notranslate"><span class="pre">test_role</span></code>, execute o script a seguir para criar objetos com escopo de banco de dados comuns a todos os tutoriais.</p>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">USE</span> <span class="ni">ROLE</span> <span class="gi">test_role</span><span class="p">;</span>
<span class="ni">USE</span> <span class="ni">DATABASE</span> <span class="gi">tutorial_db</span><span class="p">;</span>
<span class="ni">USE</span> <span class="ni">WAREHOUSE</span> <span class="gi">tutorial_warehouse</span><span class="p">;</span>

<span class="ni">CREATE</span> <span class="ni">SCHEMA</span> <span class="ni">IF</span> <span class="ni">NOT</span> <span class="ni">EXISTS</span> <span class="gi">data_schema</span><span class="p">;</span>
<span class="ni">CREATE</span> <span class="ni">IMAGE REPOSITORY</span> <span class="ni">IF</span> <span class="ni">NOT</span> <span class="ni">EXISTS</span> <span class="gi">tutorial_repository</span><span class="p">;</span>
<span class="ni">CREATE</span> <span class="ni">STAGE</span> <span class="ni">IF</span> <span class="ni">NOT</span> <span class="ni">EXISTS</span> <span class="gi">tutorial_stage</span>
  <span class="ni">DIRECTORY</span> <span class="p">=</span> <span class="p">(</span> <span class="ni">ENABLE</span> <span class="p">=</span> <span class="ni">true</span> <span class="p">);</span>
</pre></div>
</div><div data-codeblock-index="1" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
<p>Note que:</p>
<ul class="simple">
<li><p>Você cria um repositório de imagens para armazenar seu código de serviço (imagens de contêiner).</p></li>
<li><p>Você cria um estágio Snowflake para armazenar seus arquivos de especificação de serviço no tutorial 2 e 3.</p></li>
</ul>
</li>
</ol>
</section>
<section id="verify-that-you-are-ready-to-continue">
<span id="label-snowpark-containers-common-setup-verify-ready"></span><h2>Verificação se você está pronto para continuar<a class="headerlink" href="#verify-that-you-are-ready-to-continue" title="Link to this heading" data-nosnippet="">¶</a></h2>
<ol class="arabic">
<li><p>Para verificar se você possui os objetos necessários para os tutoriais, execute os seguintes comandos:</p>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">SHOW</span> <span class="ni">COMPUTE</span> <span class="ni">POOLS</span><span class="p">;</span> <span class="py">--or DESCRIBE COMPUTE POOL tutorial_compute_pool;</span>
</pre></div>
</div><div data-codeblock-index="2" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">SHOW WAREHOUSES</span><span class="p">;</span>
</pre></div>
</div><div data-codeblock-index="3" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">SHOW</span> <span class="ni">IMAGE REPOSITORIES</span><span class="p">;</span>
</pre></div>
</div><div data-codeblock-index="4" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="ni">SHOW</span> <span class="ni">STAGES</span><span class="p">;</span>
</pre></div>
</div><div data-codeblock-index="5" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
</li>
<li><p>Para verificar se você possui as informações da sua conta (nomes da organização e da conta), use um dos seguintes métodos:</p>
<ul>
<li><p>Encontre as informações na interface da web do Snowsight, no canto inferior esquerdo da página inicial.</p></li>
<li><p>EmSnowSQL CLI, execute SHOW IMAGE REPOSITORIES. O comando retorna o URL do repositório, incluindo os nomes da organização e da conta.</p>
<p><strong>Exemplo</strong></p>
<div class="relative group text-sm"><div class="highlight-sqlexample notranslate"><div class="highlight"><pre><span></span><span class="p">&lt;</span><span class="gi">orgname</span><span class="p">&gt;-&lt;</span><span class="gi">acctname</span><span class="p">&gt;.</span><span class="gi">registry</span><span class="p">.</span><span class="gi">snowflakecomputing</span><span class="p">.</span><span class="gi">com</span><span class="p">/</span><span class="gi">tutorial_db</span><span class="p">/</span><span class="gi">data_schema</span><span class="p">/</span><span class="gi">tutorial_repository</span>
</pre></div>
</div><div data-codeblock-index="6" class="copybutton"><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 384 512" class="copybutton-icon icon-copy"><path d="M192 0c-41.8 0-77.4 26.7-90.5 64H64C28.7 64 0 92.7 0 128V448c0 35.3 28.7 64 64 64H320c35.3 0 64-28.7 64-64V128c0-35.3-28.7-64-64-64H282.5C269.4 26.7 233.8 0 192 0zm0 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64zM112 192H272c8.8 0 16 7.2 16 16s-7.2 16-16 16H112c-8.8 0-16-7.2-16-16s7.2-16 16-16z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 512 512" class="copybutton-icon icon-copied hidden"><path d="M470.6 105.4c12.5 12.5 12.5 32.8 0 45.3l-256 256c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0L192 338.7 425.4 105.4c12.5-12.5 32.8-12.5 45.3 0z"></path></svg><span>Copy</span></div></div>
</li>
</ul>
</li>
</ol>
<section id="what-s-next">
<span id="label-snowpark-containers-tutorials-common-setup-what-next"></span><h3>Qual é o próximo passo?<a class="headerlink" href="#what-s-next" title="Link to this heading" data-nosnippet="">¶</a></h3>
<p>Agora você pode explorar o <a class="reference internal" href="tutorial-1"><span class="doc">Tutorial 1</span></a>.</p>
</section>
</section>
</section>
<script type="application/json" id="metadata">{
    "categories": "App Development",
    "duration": "20",
    "summary": "This tutorial provides instructions for the common setup required for all Snowpark Container Services tutorials."
}</script>



This tutorial provides instructions for the common setup required for all Snowpark Container Services tutorials.