
  



  
  <section id="common-setup-for-snowpark-container-services-tutorials">
<h1>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"><a class="image-small reference internal" href="../../../_images/logo-snowflake-black.png"><img alt="검은색 Snowflake 로고(텍스트 없음)" class="image-small" src="../../../_images/logo-snowflake-black.png" style="width: 15px; height: 15px;"></a> 기능 — 일반 공급으로 제공</p>
<p><a href="#id1"><span class="problematic" id="id2">|</span></a>spcs|는 <span class="xref std std-ref">AWS, Microsoft Azure, Google Cloud Platform 상업 리전&lt;label-na_general_regions&gt;`의 계정에서 사용할 수 있습니다(일부 예외 있음). 자세한 내용은 :ref:`label-snowpark_containers_overview_available_regions</span> 섹션을 참조하세요.</p>
</aside>

<section id="introduction">
<h2>소개<a class="headerlink" href="#introduction" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>이 항목에서는 이 설명서에서 제공되는 모든 Snowpark Container Services 자습서에 필요한 공통 설정에 대한 지침을 제공합니다.</p>
</section>
<section id="configure-prerequisites">
<h2>필수 구성 요소 구성하기<a class="headerlink" href="#configure-prerequisites" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>자습서를 완료할 수 있는지 확인하려면 다음 필수 구성 요소를 검토하십시오.</p>
<ul class="simple">
<li><p><strong>Snowflake 계정:</strong> 평가판 계정은 지원되지 않습니다.</p></li>
<li><p><strong>SQL 명령 실행을 위한 명령줄 클라이언트 SnowSQL(선택 사항):</strong> SQL 명령 실행과 Snowflake 스테이지로의 파일 업로드를 지원하는 모든 Snowflake 클라이언트를 사용할 수 있습니다. SnowSQL 및 <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> 웹 인터페이스를 사용하여 자습서를 테스트했습니다. 이 명령줄 클라이언트 설치 지침은 <a class="reference internal" href="../../../user-guide/snowsql-install-config"><span class="doc">SnowSQL 설치하기</span></a> 섹션을 참조하십시오.</p></li>
<li><p><strong>Docker Desktop:</strong> 이 자습서에서는 Docker Desktop 사용 지침을 제공합니다. 설치 지침은 <a class="reference external" href="https://docs.docker.com/get-docker/">https://docs.docker.com/get-docker/</a> 섹션을 참조하십시오.  OCI 호환 클라이언트를 사용하여 Docker, Podman 또는 Nerdctl과 같은 이미지를 생성할 수 있습니다.</p></li>
</ul>
</section>
<section id="create-snowflake-objects">
<span id="label-snowpark-containers-common-setup-create-objects"></span><h2>Snowflake 오브젝트 만들기<a class="headerlink" href="#create-snowflake-objects" title="Link to this heading" data-nosnippet="">¶</a></h2>
<p>SnowSQL 또는 Snowsight 를 사용하여 제공된 SQL을 실행합니다.</p>
<ol class="arabic">
<li><p>ACCOUNTADMIN 역할의 사용자로 Snowflake에 로그인합니다.</p></li>
<li><p>ACCOUNTADMIN 역할을 사용해 다음 스크립트를 실행하여 <code class="samp docutils literal notranslate"><em><span class="pre">user_name</span></em></code> 을 자습서를 테스트할 Snowflake 사용자의 이름으로 바꿉니다. 이러한 자습서에서는 이 스크립트를 실행하는 동일한 사용자를 선택하거나 Snowflake 계정의 다른 사용자를 선택할 수 있습니다. 이 스크립트는 다음을 수행합니다.</p>
<ul class="simple">
<li><p>역할(<code class="docutils literal notranslate"><span class="pre">test_role</span></code>) 및 기타 Snowflake 오브젝트를 생성합니다. 역할과 오브젝트를 생성하려면 ACCOUNTADMIN 역할을 사용해야 합니다. (이 제한은 비용을 통제하고 비즈니스 정보 위험을 관리하는 데 도움이 됩니다.) 또한 이 스크립트는 새로 생성된 오브젝트를 관리하는 데 필요한 권한을 <code class="docutils literal notranslate"><span class="pre">test_role</span></code> 역할에 부여합니다.</p></li>
<li><p>지정된 Snowflake 사용자에게 역할을 부여하면 해당 사용자는 부여된 역할을 사용하여 자습서를 살펴볼 수 있습니다.</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>참고:</p>
<ul class="simple">
<li><p>서비스(작업 서비스 포함)가 SQL DML 문(예: SELECT 및 INSERT)을 실행할 수 있으므로 웨어하우스를 생성합니다. Snowflake는 웨어하우스에서 이러한 문을 실행합니다.</p></li>
<li><p>자습서 1에서는 사용자가 공용 웹(수신)에서 서비스에 액세스할 수 있도록 엔드포인트를 공개로 노출하는 서비스를 만듭니다. 이 서비스를 만들려면 다음을 수행하십시오.</p>
<ul>
<li><p>역할 <code class="code docutils literal notranslate"><span class="pre">test_role</span></code> 에는 계정에 대한 BIND SERVICE ENDPOINT 권한이 있어야 합니다.</p></li>
<li><p>현재 구현에는 스크립트가 생성하는 보안 통합이 필요합니다.</p></li>
</ul>
</li>
<li><p><a class="reference internal" href="../working-with-compute-pool"><span class="doc">컴퓨팅 풀</span></a> 은 Snowflake가 서비스를 실행하는 하나 이상의 가상 머신(VM) 노드 모음입니다.</p></li>
</ul>
</li>
<li><p>이전 스크립트에 지정된 사용자로 Snowflake에 로그인했는지 확인하십시오.</p></li>
<li><p><code class="code docutils literal notranslate"><span class="pre">test_role</span></code> 역할을 사용하여 다음 스크립트를 실행하여 모든 자습서에 공통된 데이터베이스 범위가 지정된 오브젝트를 실행합니다.</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>참고:</p>
<ul class="simple">
<li><p>서비스 코드(컨테이너 이미지)를 저장할 이미지 리포지토리를 만듭니다.</p></li>
<li><p>자습서 2 및 3에서 서비스 사양 파일을 저장하는 Snowflake 스테이지를 만듭니다.</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>계속할 준비가 되었는지 확인합니다.<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>자습서에 필요한 오브젝트가 있는지 확인하려면 다음 명령을 실행하십시오.</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>계정 정보(조직 및 계정 이름)가 있는지 확인하려면 다음 방법 중 하나를 사용하십시오.</p>
<ul>
<li><p>홈 페이지 왼쪽 하단에 있는 Snowsight 웹 인터페이스에서 정보를 찾으십시오.</p></li>
<li><p>SnowSQL CLI에서 SHOW IMAGE REPOSITORIES를 실행합니다. 이 명령은 조직 및 계정 이름을 포함하여 리포지토리 URL을 반환합니다.</p>
<p><strong>예</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>다음에는 무엇을 해야 합니까?<a class="headerlink" href="#what-s-next" title="Link to this heading" data-nosnippet="">¶</a></h3>
<p>이제 <a class="reference internal" href="tutorial-1"><span class="doc">자습서 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.