Reunalaskenta Cloudflare Workersilla ja Denolla · Oppitunti

Cloudflare KV -tietovarasto

Hyödynnä Cloudflare Workers KV:tä avain–arvo-tallennukseen reunalla, esimerkiksi välimuistia ja määrityksiä varten

Oppitunti 1/412 vaihetta

Cloudflare KV -tietovarasto on ilmainen Reunalaskenta Cloudflare Workersilla ja Denolla-oppitunti CoddyKitissä. Tämä on oppitunti 1/4. Voit lukea koko oppitunnin alta ilmaiseksi ja harjoitella sen jälkeen käytännössä selaimessa sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla. Oppitunti kuuluu Reunalaskenta Cloudflare Workersilla ja Denolla-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Reunalaskenta Cloudflare Workersilla ja Denolla-kurssilla on yhteensä 4 oppituntia.

Edge-data KV-tallennustilalla

Tervetuloa Cloudflare KV:n pariin! Se on erittäin hajautettu avain–arvo-tietovarasto, joka toimii Cloudflaren maailmanlaajuisessa verkossa suoraan edgessä.

Tämä tarkoittaa, että tietonne tallennetaan erittäin lähelle käyttäjiänne, mikä mahdollistaa erittäin nopean käytön ja pienen viiveen. Se sopii erinomaisesti dynaamiselle sisällölle, määrityksille ja välimuistille.

Miten avain–arvo-tallennus toimii

Avain–arvo-tietovarasto on kuin yksinkertainen sanakirja tai map-rakenne. Tiedot tallennetaan yksilöllisinä avain–arvo-pareina. Avain on yksilöllinen tunniste (merkkijono), ja arvo on kyseiseen avaimeen liittyvä data.

Avaimet: Ajatelkaa niitä yksilöllisinä niminä, kuten "user_id_123" tai "website_config".
Arvot: Ne ovat varsinaista dataa, joka voi olla merkkijonoja, lukuja, JSON-objekteja (merkkijonoina) tai jopa binaaridataa.

KV:n edge-edut

Miksi KV:tä kannattaa käyttää edgessä?

Nopeus: Data tarjotaan lähimmästä Cloudflare-datakeskuksesta, mikä pienentää viivettä.
Yksinkertaisuus: KV ei edellytä skeemaa, joten tietojen tallentaminen ja hakeminen onnistuu helposti ilman monimutkaisia tietokantaskeemoja.
Skaalautuvuus: Skaalautuu automaattisesti käsittelemään valtavaa liikennettä ja maailmanlaajuista jakelua.
Kustannustehokkuus: On usein perinteisiä tietokantoja edullisempi tietyissä käyttötapauksissa.

KV:n käytännön sovellukset

Cloudflare KV soveltuu moniin edge-ympäristön erityistehtäviin:

Välimuisti: Usein käytettyjen API-vastausten, HTML-katkelmien tai staattisten resurssien tallentaminen.
Määritykset: Dynaamisten ominaisuuslippujen, A/B-testiasetusten tai uudelleenohjaussääntöjen hallinta.
Personointi: Yksinkertaisten käyttäjäasetusten, kuten teeman tai kielen, tallentaminen.
Pyynnönopeuden rajoittaminen: Käyttäjä- tai IP-osoitekohtaisen pyyntömäärän seuranta.

KV-nimiavaruuden luominen

Ennen KV:n käyttöä on luotava nimiavaruus. Nimiavaruus on looginen säilö avain–arvo-pareille, ja se pitää datanne järjestyksessä.

Voitte luoda uuden KV-nimiavaruuden Cloudflare-hallintapaneelissa tai käyttämällä Wrangler CLI-työkalua (Cloudflaren komentorivityökalua).

KV:n sitominen Workeriin

Jotta voitte käyttää KV-nimiavaruutta Workerissa, se on sidottava wrangler.toml-määritystiedostossa. Tämän ansiosta KV-nimiavaruus on käytettävissä globaalina muuttujana Worker-skriptissä.

Sidonta määritellään seuraavasti:

name = "my-worker"
main = "src/index.js"
compatibility_date = "2024-01-01"

[[kv_namespaces]]
binding = "MY_KV_STORE" # The variable name in your Worker
id = "YOUR_NAMESPACE_ID" # Get this from Cloudflare dashboard

Tietojen tallentaminen komennolla `put`

put()-metodilla tallennetaan tietoja KV-nimiavaruuteen. Se saa argumenteikseen avaimen ja arvon. Arvot voivat olla merkkijonoja, ArrayBuffer-objekteja tai ReadableStream-objekteja.

Kokeilkaa tämän esimerkki-Workerin suorittamista:

export default {
  async fetch(request, env, ctx) {
    const key = "user_setting";
    const value = "dark_mode";
    
    // Store the value in the MY_KV_STORE namespace
    await env.MY_KV_STORE.put(key, value);
    
    return new Response(`Stored '${value}' for key '${key}'`);
  },
};

Tietojen hakeminen komennolla `get`

Arvo haetaan käyttämällä get()-metodia ja antamalla sille avain. Jos avainta ei ole olemassa, get() palauttaa arvon null.

Tämä esimerkki yrittää hakea juuri tallentamamme asetuksen:

export default {
  async fetch(request, env, ctx) {
    const key = "user_setting";
    
    // Retrieve the value from the MY_KV_STORE namespace
    const value = await env.MY_KV_STORE.get(key);
    
    if (value === null) {
      return new Response(`Key '${key}' not found.`, { status: 404 });
    }
    
    return new Response(`Retrieved: '${value}'`);
  },
};

Tietojen poistaminen komennolla `delete`

Jos haluatte poistaa avain–arvo-parin nimiavaruudestanne, käyttäkää delete()-metodia ja antakaa sille poistettava avain.

Tallennettu asetus poistetaan näin:

export default {
  async fetch(request, env, ctx) {
    const key = "user_setting";
    
    // Delete the key-value pair from the MY_KV_STORE namespace
    await env.MY_KV_STORE.delete(key);
    
    return new Response(`Key '${key}' deleted.`);
  },
};

Avainten luetteleminen KV:ssä

Cloudflare KV tarjoaa myös list()-metodin, jolla voidaan hakea nimiavaruuden avainten luettelo. Tästä voi olla hyötyä hallinnollisissa tehtävissä tai KV-tietovaraston sisällön tarkastelussa.

Se palauttaa usein objektin, joka sisältää keys-taulukon ja list_complete-boolean-arvon.

// Example of listing keys (inside a Worker's fetch handler)
const { keys } = await env.MY_KV_STORE.list();

// To get just the names:
const keyNames = keys.map(k => k.name);
console.log(keyNames);

KV-toimintojen tarkistus

Mitkä seuraavista Cloudflare KV:tä koskevista väitteistä ovat totta?

Vastaa interaktiivisessa oppitunnissa

Kertaus: Cloudflare KV -tietovarasto

Tässä oppitunnissa opitte Cloudflare KV:stä, joka on edgelle optimoitu tehokas avain–arvo-tietovarasto. Käsittelimme seuraavat aiheet:

Mikä KV on ja mitkä ovat sen edut matalan viiveen tietojen käytössä.
Yleiset käyttötapaukset, kuten välimuisti ja määritykset.
KV-nimiavaruuden luominen ja sen sitominen Cloudflare Workeriin.
Keskeiset toiminnot: put() tietojen tallentamiseen, get() niiden hakemiseen ja delete() niiden poistamiseen.

KV on olennainen työkalu nopeiden, skaalautuvien ja tehokkaiden edge-sovellusten rakentamiseen!

Aloita maksutta

Opi Reunalaskenta Cloudflare Workersilla ja Denolla tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit: 12
Oppitunnit: 47

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Cloudflare KV -tietovarasto” ilmainen?

Kyllä – oppitunnin ”Cloudflare KV -tietovarasto” koko tekstin voi lukea täällä verkossa ilmaiseksi. Jos haluat harjoitella interaktiivisesti sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla sekä avata koko Reunalaskenta Cloudflare Workersilla ja Denolla-kurssin, päivitä CoddyKit PROhon. Reunalaskenta Cloudflare Workersilla ja Denolla-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Cloudflare KV -tietovarasto”?

Hyödynnä Cloudflare Workers KV:tä avain–arvo-tallennukseen reunalla, esimerkiksi välimuistia ja määrityksiä varten Harjoittelet Reunalaskenta Cloudflare Workersilla ja Denolla-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Reunalaskenta Cloudflare Workersilla ja Denolla-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Reunalaskenta Cloudflare Workersilla ja Denolla-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 1/4.

Kuinka kauan ”Cloudflare KV -tietovarasto”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä Reunalaskenta Cloudflare Workersilla ja Denolla-oppitunnilla?

Kyllä. Jokainen Reunalaskenta Cloudflare Workersilla ja Denolla-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

← Takaisin: Reunalaskenta Cloudflare Workersilla ja Denolla