Tento výukový program používá klienta příkazového řádku Snowflake, SnowSQL , k představení klíčových konceptů a úkolů, včetně:
- Vytváření objektů Snowflake – vytvoříte databázi a tabulku pro ukládání dat.
- Načítání dat – Poskytujeme malé vzorové datové soubory CSV, které můžete načíst do tabulky.
- Dotazování – Prozkoumáte vzorové dotazy.
Snowflake vyžaduje virtuální sklad pro načítání dat a provádění dotazů. Běžící virtuální sklad spotřebovává kredity Snowflake; počet kreditů spotřebovaných v tomto tutoriálu je však minimální, protože celý tutoriál můžete dokončit za méně než 30 minut. Navíc Snowflake účtuje minimální částku za úložiště na disku použité pro ukázková data v tomto kurzu. Tento výukový program však poskytuje kroky k odstranění stolu a minimalizaci nákladů na úložiště. Pokud používáte 30denní zkušební účet, účet poskytuje bezplatné kredity a nebudou vám vznikat žádné náklady. Další informace o velikostech skladu a nákladech najdete v tématu Velikost skladu .
Co se naučíte¶
V tomto tutoriálu se naučíte, jak:
- Vytvořit objekty Snowflake – vytvoříte databázi a tabulku pro ukládání dat.
- Instalace SnowSQL – Nainstalujete a používáte SnowSQL, dotazovací nástroj příkazového řádku Snowflake. Uživatelé Visual Studio Code mohou zvážit použití rozšíření Snowflake pro Visual Studio Code namísto SnowSQL.
- Načtení datových souborů CSV – K načtení dat do tabulek ze souborů CSV používáte různé mechanismy.
- Zápis a provádění vzorových dotazů – Zapisujete a spouštíte řadu dotazů na nově načtená data.
Předpoklady¶
Tento kurz vyžaduje databázi, tabulku a virtuální sklad k načítání a dotazování na data. Vytvoření těchto objektů Snowflake vyžaduje uživatele Snowflake s rolí s nezbytnými oprávněními řízení přístupu. Kromě toho je pro provádění příkazů SQL ve výukovém programu vyžadován SnowSQL. A konečně, výukový program vyžaduje k načtení soubory CSV, které obsahují ukázková data.
Tento výukový program můžete dokončit pomocí existujícího skladu, databáze a tabulky Snowflake a vašich vlastních lokálních datových souborů, ale doporučujeme použít objekty Snowflake a sadu poskytnutých dat.
Chcete-li nastavit Snowflake pro tento výukový program, před pokračováním proveďte následující:
- Vytvoření uživatele Chcete-li vytvořit databázi, tabulku a virtuální sklad, musíte být přihlášeni jako uživatel Snowflake s rolí, která vám uděluje oprávnění k vytváření těchto objektů.
- Pokud používáte 30denní zkušební účet, můžete se přihlásit jako uživatel, který byl pro účet vytvořen. Tento uživatel má roli s oprávněními potřebnými k vytváření objektů.
- Pokud nemáte uživatele Snowflake, nemůžete tento návod provést. Pokud nemáte roli, která vám umožňuje vytvořit uživatele, požádejte někoho, kdo má, aby tento krok provedl za vás. Uživatelé s rolí ACCOUNTADMIN nebo SECURITYADMIN mohou vytvářet uživatele.
- Instalace SnowSQL Chcete-li nainstalovat SnowSQL, viz Instalace SnowSQL .
- Stažení ukázkových datových souborů Pro tento tutoriál si stáhnete ukázkové datové soubory zaměstnanců ve formátu CSV, který poskytuje Snowflake. Postup stažení a rozbalení ukázkových datových souborů:
- Stáhněte si sadu ukázkových datových souborů. Klikněte pravým tlačítkem na název archivního souboru, get-started.zip a uložte odkaz/soubor do místního systému souborů.
- Rozbalte ukázkové soubory. Výukový program předpokládá, že jste rozbalili soubory do jednoho z následujících adresářů:
- Linux/macOS: /tmp
- Windows: C:temp
Každý soubor má pět datových záznamů. Data používají jako oddělovač pole znak čárka (,). Následuje příklad záznamu:
Althea,Featherstone,afeatherstona@sf_tuts.com,"8172 Browning Street, Apt B",Calatrava, 7
Před nebo za čárkami oddělujícími pole v každém záznamu nejsou žádné mezery. Toto je výchozí nastavení, které Snowflake očekává při načítání dat CSV.
Přihlaste se do SnowSQL¶
Poté, co budete mít SnowSQL , spusťte SnowSQL a připojte se k Snowflake:
- Otevřete okno příkazového řádku.
- Spusťte SnowSQL:
- je jedinečný identifikátor vašeho účtu Snowflake. Preferovaný formát identifikátoru účtu je následující: Název organizace – jméno účtu Názvy vaší organizace a účtu Snowflake. Další informace naleznete v tématu Formát 1 (preferovaný): Název účtu ve vaší organizaci .
- je přihlašovací jméno pro vašeho uživatele Snowflake.
Pokud má váš účet poskytovatele identity (IdP), který byl pro váš účet definován, můžete k ověření namísto hesla použít webový prohlížeč, jak ukazuje následující příklad:
$ snowsql -a -u --authenticator externalbrowser
Pokud se úspěšně přihlásíte, SnowSQL zobrazí příkazový řádek, který obsahuje váš aktuální sklad, databázi a schéma.
Pokud ztratíte přístup k účtu a nemůžete získat identifikátor účtu, najdete jej v uvítacím e-mailu, který vám Snowflake poslal, když jste se zaregistrovali do zkušebního účtu, nebo můžete na získání účtu spolupracovat se svým ORGADMINEM. podrobnosti . Hodnoty pro lokátor , cloud a region naleznete také v uvítacím e-mailu.
Pokud váš uživatel Snowflake nemá výchozí sklad, databázi a schéma, nebo pokud jste nenakonfigurovali SnowSQL tak, aby specifikoval výchozí sklad, databázi a schéma, výzva zobrazí žádný sklad , žádnou databázi a žádné schéma . Například:
uživatelské-jméno#(žádný sklad)@(žádná databáze).(žádné schéma)>
Tato výzva označuje, že pro aktuální relaci není vybrán žádný sklad, databáze ani schéma. Tyto objekty vytvoříte v dalším kroku. Při vytváření těchto objektů podle následujících kroků v tomto kurzu se výzva automaticky aktualizuje a obsahuje názvy těchto objektů.
Vytvářejte objekty sněhové vločky¶
Během tohoto kroku vytvoříte následující objekty Snowflake:
- Databáze ( sf_tuts ) a tabulka ( emp_basic ). Do této tabulky načtete ukázková data.
- Virtuální sklad ( sf_tuts_wh ). Tento sklad poskytuje výpočetní prostředky potřebné k načtení dat do tabulky a dotazu na tabulku. Pro tento výukový program vytvoříte sklad X-Small.
Po dokončení tohoto kurzu tyto objekty odstraníte.
Vytvořit databázi¶
Vytvořte databázi sf_tuts pomocí příkazu CREATE DATABASE:
CREATE OR VÝMĚNA DATABÁZE sf_tuts;
V tomto kurzu namísto vytváření nového schématu použijete výchozí schéma ( public ) dostupné pro každou databázi.
Všimněte si, že databáze a schéma, které jste právě vytvořili, se nyní používají pro vaši aktuální relaci, jak se odráží v příkazovém řádku SnowSQL. K získání těchto informací můžete také použít kontextové funkce.
SELECT CURRENT_DATABASE(), CURRENT_SCHEMA();
Následuje příklad výsledku:
+--------------------+-------------------+ | CURRENT_DATABASE() | CURRENT_SCHEMA() | |--------------------+-------------------| | SF_TUTS | VEŘEJNOST | +--------------------+-------------------+
Vytvořte tabulku¶
Vytvořte tabulku s názvem emp_basic v sf_tuts.public pomocí příkazu CREATE TABLE:
CREATE OR VÝMĚNA TABULKA emp_basic ( jméno STRING , příjmení STRING , e-mail STRING , adresa ulice STRING , město STRING , Datum zahájení DATA );
Všimněte si, že počet sloupců v tabulce, jejich pozice a jejich datové typy odpovídají polím ve vzorových datových souborech CSV, které vytvoříte v dalším kroku tohoto kurzu.
Vytvořte virtuální sklad¶
Vytvořte X-Small sklad s názvem sf_tuts_wh pomocí příkazu CREATE WAREHOUSE:
CREATE OR VÝMĚNA SKLAD sf_tuts_wh S WAREHOUSE_SIZE='X-SMALL' AUTO_SUSPEND = 180 AUTO_RESUME = TRUE INITIALLY_SUSPENDED=TRUE;
Sklad sf_tuts_wh je zpočátku pozastaven, ale příkaz DML také nastavuje AUTO_RESUME = true . Nastavení AUTO_RESUME způsobí, že se sklad automaticky spustí, když jsou provedeny příkazy SQL, které vyžadují výpočetní prostředky.
Po vytvoření skladu se nyní používá pro vaši aktuální relaci. Tyto informace se zobrazí v příkazovém řádku SnowSQL. Název skladu můžete také získat pomocí následující kontextové funkce:
SELECT CURRENT_WAREHOUSE();
Následuje příklad výsledku:
+----------------------+ | CURRENT_WAREHOUSE() | |----------------------| | SF_TUTS_WH | +----------------------+
Datové soubory fáze¶
Fáze Snowflake je umístění v cloudovém úložišti, které používáte k načítání a vyjímání dat z tabulky. Snowflake podporuje následující typy fází:
- Vnitřní fáze—Slouží k internímu ukládání datových souborů v rámci Snowflake. Každý uživatel a tabulka ve Snowflake dostane ve výchozím nastavení interní fázi pro pracovní datové soubory.
- Vnější fáze– Používá se k externímu ukládání datových souborů v Amazon S3, Google Cloud Storage nebo Microsoft Azure. Pokud jsou vaše data již uložena v těchto službách cloudového úložiště, můžete k načtení dat v tabulkách Snowflake použít externí platformu.
V tomto kurzu nahrajeme ukázkové datové soubory (stažené v části Předpoklady ) do interní fáze pro tabulku emp_basic, kterou jste vytvořili dříve. Pomocí příkazu PUT nahrajete ukázkové datové soubory do této fáze.
Příprava ukázkových datových souborů¶
Provedením příkazu PUT v SnowSQL nahrajte místní datové soubory do fáze tabulky poskytnuté pro vámi vytvořenou tabulku emp_basic.
PUT soubor:/ /soubor-cesta>[/]zaměstnanci0*.csv @sf_tuts.na veřejnosti.%emp_basic;
