> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# A Snowflake csatlakoztatása az alkalmazáshoz

> Csatlakoztassa a Snowflake-et az alkalmazáshoz az adattárház adatainak lekérdezéséhez.

Csatlakoztassa alkalmazását a Snowflake-hez, hogy lekérdezze az adattárház adatait, elemzéseket futtasson, és az eredményeket irányítópultokon, jelentésekben és munkafolyamatokban használja.

***

## Mit tehet

Használja adattárháza adatait kérdések megválaszolására és csapata tájékoztatására.

> [card] Adattárház-adatok lekérdezése
>
> Futtasson SQL-t a Snowflake-adattárházán, és jelenítse meg az eredményeket az alkalmazásban.

> [card] Elemzési irányítópultok építése
>
> Jelenítse meg az adattárház eredményeit diagramokon, táblázatokban és irányítópultokon.

> [card] Adat-munkafolyamatok automatizálása
>
> Használjon Snowflake-lekérdezéseket munkafolyamatokban, például küldjön riasztást egy Slack-csatornára, ha egy mutató csökken.

**Példapromptok**

Írja le az MI-csevegésben, milyen adatokat szeretne, mi indítja a lekérdezést, és milyen dinamikus mezők vannak. Például:

```text wrap theme={null}
Kérdezze le az értékesítési adatokat a Snowflake-adattárházamból, és jelenítse meg az eredményeket.
```

```text wrap theme={null}
Futtasson elemzési jelentést a Snowflake-ben tárolt ügyféladatokon.
```

```text wrap theme={null}
Kérje le a készletszinteket a Snowflake-adattárházból.
```

```text wrap theme={null}
Futtasson SQL-lekérdezést a Snowflake-tábláim trendjeinek elemzéséhez.
```

```text wrap theme={null}
Mutassa meg, milyen adatbázisaim és tábláim vannak a Snowflake-ben.
```

***

## Az OAuth beállítása a Snowflake-ben

A Snowflake OAuth biztonsági integrációt használ. Hozza létre a Snowflake-ben, mielőtt regisztrálja az összekötőt a Base44-ben.

**1. A Base44 visszahívási URL-jének beszerzése**

A Base44-ben kezdje el hozzáadni a Snowflake-összekötőt a munkaterület Connectors oldaláról. Másolja ki az űrlapról a **Visszahívási URL** értékét. Az alábbi SQL ezt regisztrálja `OAUTH_REDIRECT_URI` értékként.

**2. Az OAuth biztonsági integráció létrehozása**

Használja az `ACCOUNTADMIN` szerepkört, vagy egy globális `CREATE INTEGRATION` jogosultsággal rendelkező szerepkört. Ez a példa az `ACCOUNTADMIN` szerepkört használja. Ha másik szerepkört használ, cserélje le az első utasítást.

```sql theme={null}
USE ROLE ACCOUNTADMIN;

CREATE SECURITY INTEGRATION BASE44_OAUTH
  TYPE                         = OAUTH
  OAUTH_CLIENT                 = CUSTOM
  OAUTH_CLIENT_TYPE            = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI           = 'https://connectors.base44.com/api/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS   = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  ENABLED                      = TRUE;
```

Ez 90 napra állítja a frissítési tokenek érvényességét, ami a Snowflake alapértelmezett és egyben maximális értéke.

Ha az **Átirányítási URI-k megtekintése** további URL-eket mutat meglévő kapcsolatokhoz, mindegyiket adja hozzá az `OAUTH_ALTERNATE_REDIRECT_URIS` értékhez ebben a `CREATE SECURITY INTEGRATION` utasításban.

Ha más integrációnevet választ, azt használja a többi SQL-utasításban is.

**3. A kapcsolati adatok beszerzése**

Olvassa ki a Client ID és a Client Secret értékét.

```sql theme={null}
SELECT
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_ID::STRING     AS client_id,
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_SECRET::STRING AS client_secret;
```

Mindkét értékhez használja a cella másolás gombját. A Client ID gyakran `=` karakterre végződik, és ennek elhagyása megszakítja a kapcsolatot.

Kérje le a Snowflake-fiókazonosítót, amelyet a Base44-ben ad meg.

```sql theme={null}
SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME() AS account_identifier;
```

**4. A Snowflake-identitás előkészítése**

Használjon olyan normál Snowflake-identitást, amelynél be van állítva a `DEFAULT_ROLE` és a `DEFAULT_WAREHOUSE`. A szerepkörének hozzá kell férnie az alkalmazás által lekérdezett adatbázisokhoz és objektumokhoz, és jogosultnak kell lennie az adattárház használatára.

A Snowflake alapértelmezés szerint letiltja, hogy az `ACCOUNTADMIN`, a `SECURITYADMIN`, az `ORGADMIN` és a `GLOBALORGADMIN` használja ezt az integrációt. Ez a Snowflake biztonsági alapbeállítása, nem a Base44 korlátozása.

> [accordion] Már van OAuth-integrációja?
>
> Meglévő integráció módosításához használja az `ALTER` utasítást. A `CREATE OR REPLACE` törli és újra létrehozza az integrációt, ezért átirányítási URI módosításához ne használja.
>
> Ha az integráció már létezik, és csak a visszahívási URL-t kell frissíteni, inkább ezt futtassa.
>
> ```sql theme={null}
> ALTER SECURITY INTEGRATION BASE44_OAUTH
>   SET OAUTH_REDIRECT_URI = 'https://connectors.base44.com/api/oauth/callback';
> ```
>
> Ha az **Átirányítási URI-k megtekintése** meglévő kapcsolatokhoz tartozó URL-eket mutat, az összes további URL-t adja meg az `OAUTH_ALTERNATE_REDIRECT_URIS` értékben. A már regisztrált alternatív URL-eket tartsa meg.
>
> ```sql theme={null}
> ALTER SECURITY INTEGRATION BASE44_OAUTH
>   SET OAUTH_ALTERNATE_REDIRECT_URIS = ('<additional callback URL>');
> ```

***

## A Snowflake csatlakoztatása

Csatlakoztassa a Snowflake-et, hogy az alkalmazás lekérdezhesse az adattárházat.

> [!TIP]
>
> **Mielőtt elkezdené:**
>
> * **Snowflake OAuth-integráció:** Hozzon létre egy Snowflake OAuth biztonsági integrációt, hogy legyen **Client ID** és **Client Secret** értéke. Lásd: [Az OAuth beállítása a Snowflake-ben](#setting-up-oauth-in-snowflake).
> * **Snowflake-fiókazonosító:** A Snowflake webes felületén kattintson a bal alsó sarokban a fiókja nevére, válassza a **Copy account URL** lehetőséget, és használja a `.snowflakecomputing.com` előtti részt. Az azonosítót az [Az OAuth beállítása a Snowflake-ben](#setting-up-oauth-in-snowflake) részben szereplő SQL-lel is lekérheti.
> * **Base44-munkaterület-hozzáférés:** Az összekötő Base44-ben való regisztrálásához a munkaterület tulajdonosának vagy adminisztrátorának kell lennie.
> * **Snowflake-hozzáférés:** Minden csatlakozó személynek hozzáféréssel kell rendelkeznie a lekérdezni kívánt adatbázisokhoz.

**A Snowflake hozzáadása a Connectors oldalról:**

1. Kattintson a munkaterület oldalsávjában az **Összekötők** elemre.
2. Kattintson az **Összekötő hozzáadása** gombra.
3. Keressen rá a **Snowflake** kifejezésre, és kattintson rá.
4. Ellenőrizze, hogy a **Visszahívási URL** megegyezik-e a Snowflake biztonsági integráció `OAUTH_REDIRECT_URI` értékével.
5. Adja meg az **Összekötő neve** értékét.
6. Adja meg a Snowflake OAuth-integrációból származó **Client ID** és **Client Secret** értéket.
7. Tartsa meg a **refresh token** [hatókört](#scopes-and-permissions) a **Hatókörök** alatt, a **További hatókörök** mezőt pedig hagyja üresen.
8. A **Kapcsolat konfigurációja** alatt adja meg a **Snowflake Account** azonosítót `orgname-account_name` formátumban, például `nzajreo-sp04035`. Ne írja hozzá a `.snowflakecomputing.com` részt, és ne használja a régi fiókazonosítót (account locator).
9. Kattintson az **Összekötő hozzáadása** gombra.
10. Nyissa meg az alkalmazást az alkalmazásszerkesztőben.
11. Kérje meg az MI-csevegést, hogy adjon hozzá egy Snowflake-funkciót.
12. Amikor a rendszer kéri, engedélyezze a fiókot.

Az alkalmazás használhat egyetlen megosztott Snowflake-kapcsolatot, vagy engedheti, hogy mindenki a saját fiókját csatlakoztassa. Mondja meg az MI-csevegésnek, melyiket szeretné.

***

## Hatókörök és engedélyek

A Snowflake-jogosultságai határozzák meg, mely adattárház-adatokat kérdezheti le az alkalmazás.

> [card]
>
> **1. Amit a Base44 hozzáad**
>
> * `refresh_token`: Újabb bejelentkezés nélkül frissíti a kapcsolatot
>
> **2. Amit Ön konfigurál**
>
> * Hagyja üresen a **További hatókörök** mezőt. A Snowflake a nem támogatott értékeket, például az `account:read` értéket a **The requested scope is invalid** hibával utasítja el.
> * Ne adja hozzá a `session:role:<role>` értéket.
>
> **Hozzáférés:** A Snowflake a kapcsolatot engedélyező identitás alapértelmezett szerepkörét és jogosultságait használja.

***

## A Snowflake használata backend-függvényben

A Snowflake csatlakoztatása után a backend-függvények hozzáférési tokent kérhetnek le, és lekérdezhetik az adattárházat. Az OAuth-folyamatot és a hitelesítő adatok tárolását a Base44 kezeli.

> [tab] Megosztott összekötő
>
> A `getWorkspaceConnection(connectorId)` metódust akkor használja, ha az alkalmazás egyetlen megosztott Snowflake-identitást használ.
>
> ```javascript theme={null}
> import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";
>
> Deno.serve(async (req) => {
>   const base44 = createClientFromRequest(req);
>   const connectorId = "YOUR_CONNECTOR_ID";
>
>   const { accessToken, connectionConfig } =
>     await base44.asServiceRole.connectors.getWorkspaceConnection(connectorId);
>
>   // Use accessToken to query Snowflake.
>   return Response.json({ account: connectionConfig.subdomain });
> });
> ```

> [tab] Alkalmazásfelhasználói összekötő
>
> A `getCurrentAppUserConnection(connectorId)` metódust akkor használja, ha mindenki a saját Snowflake-identitásával csatlakozik.
>
> ```javascript theme={null}
> import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";
>
> Deno.serve(async (req) => {
>   const base44 = createClientFromRequest(req);
>   const user = await base44.auth.me();
>
>   if (!user) {
>     return Response.json({ error: "Unauthorized" }, { status: 401 });
>   }
>
>   const connectorId = "YOUR_CONNECTOR_ID";
>   const { accessToken, connectionConfig } =
>     await base44.asServiceRole.connectors.getCurrentAppUserConnection(connectorId);
>
>   // Use accessToken to query Snowflake for the signed-in person.
>   return Response.json({ account: connectionConfig.subdomain });
> });
> ```

> [card] [Összekötők (fejlesztői dokumentáció)](https://docs.base44.com/hu/developers/backend/resources/connectors.md)
>
> Kapcsolat lekérése, adatainak kiolvasása és a szolgáltatás API-jának hívása backend-függvényből.

***

## Hibaelhárítás

Ha a Snowflake nem tud csatlakozni vagy lekérdezéseket futtatni, ellenőrizze a szerepköröket, az adattárház-hozzáférést és a visszahívási URL-eket.

> [accordion] A lekérdezések adattárház- vagy hozzáférési hibával hiúsulnak meg
>
> Ellenőrizze a csatlakoztatott Snowflake-identitás `DEFAULT_ROLE` és `DEFAULT_WAREHOUSE` értékét. A szerepkörnek `USAGE` jogosultság kell az adattárházhoz, az adatbázishoz és a sémához, valamint `SELECT` jogosultság az alkalmazás által lekérdezett táblákhoz vagy nézetekhez. Alkalmazásfelhasználói kapcsolat esetén ellenőrizze minden személy Snowflake-szerepkörét és jogosultságait.

> [accordion] A kapcsolat átirányítási URI-eltérés miatt hiúsul meg
>
> Az általános javítást lásd az [átirányítási URI-hibáknál](https://docs.base44.com/hu/Integrations/Connectors.md#why-does-connecting-fail-with-a-redirect-uri-error). A Snowflake-ben ellenőrizze, hogy az integráció engedélyezve van-e, és vesse össze a regisztrált átirányítási URI-kat a kapcsolat által használt URL-ekkel.
>
> ```sql theme={null}
> DESC SECURITY INTEGRATION BASE44_OAUTH;
> ```
>
> Ellenőrizze, hogy a Base44 által mutatott minden URI regisztrálva van-e `OAUTH_REDIRECT_URI` értékként vagy az `OAUTH_ALTERNATE_REDIRECT_URIS` listában. A Snowflake karakterről karakterre egyezteti az átirányítási URI-kat.

> [accordion] A kapcsolat azért hiúsul meg, mert a szerepköre le van tiltva
>
> Kiemelt jogosultságú szerepkörrel jelentkezett be. A Snowflake alapértelmezés szerint letiltja, hogy az `ACCOUNTADMIN`, a `SECURITYADMIN`, az `ORGADMIN` és a `GLOBALORGADMIN` használja az integrációt. Jelentkezzen be inkább egy normál Snowflake-felhasználóval.

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.