Tallenna ja hallinnoi tiedostoja Fabric Appsissa

Fabric Apps Storage on rakennettu OneLake-pohjalle ja antaa sinun lisätä asiakirjoja, kuvia ja liitteitä sovellukseesi. Määrittele kansiot ja pääsysäännöt Rayfinillä, ja käytä sitten asiakas-SDK:ta tiedostojen lataamiseen, listaamiseen, lataamiseen ja poistamiseen. Pidä rakenteelliset sovellustiedot tietomalleissasi.

Tiedostotoiminnot käyttävät Fabric-tallennusta kehityksen aikana ja käyttöönoton jälkeen; paikallista tallennusemulaattoria ei ole.

Vaatimukset

Ota OneLake-yhteys käyttöön

Tiedostojen lataukset ja lataukset riippuvat OneLaken käytöstä. Pyydä Fabric-ylläpitäjääsi, jotta käyttäjät voivat käyttää OneLakeen tallennettuja tietoja sovelluksissa, jotka ovat Fabric-vuokralaisen ulkopuolella. Se on oletuksena käytössä koko organisaatiolle. Fabric Apps Storage vaatii tämän asetuksen olevan käytössä. Tämä asetus säätelee pääsyä sovelluksista Fabric:n ulkopuolelta yleensä, ei vain sinun sovelluksesi. Sinun täytyy myös määritellä kansion käyttöoikeudet, jotta voit hallita, mihin tiedostoihin kukin sovelluskäyttäjä pääsee käsiksi. Lisätietoja löytyy OneLake-vuokralaisasetuksista.

Ota tallennus käyttöön

Käytä GitHub Copilot tai muuta koodausagenttia, jolla on pääsy projektiisi ja terminaaliisi, tallentamisen konfigurointiin. Esimerkiksi käytä seuraavaa kehotetta:

Use Rayfin Storage to add a documents folder to my Fabric app.
Allow signed-in users to manage their own PDF files, up to 10 MiB each.
Use the installed Rayfin documentation and project guidance to configure and
register the folder, and connect storage to my existing authenticated client.
Preserve my existing services and folders. Show me the changes before deploying,
and ask before making any potentially destructive changes.

Käy läpi generoidut asetukset, kansion oikeudet ja asiakasmuutokset. Tallennus vaatii, että datapalvelu on aktivoitu ja konfiguroitu. Jokainen kansio vaatii todennuksen mukaisen käyttöoikeussäännön. Kansion käyttöoikeudet ohjaavat pääsyä tiedostoihin; polut järjestävät vain sisällön. Lisätietoja käyttöoikeuksista löytyy kohdasta Määrittele datan käyttöoikeudet.

Sovella konfiguraatiota

Ota sovelluksesi käyttöön projektin juuresta:

npx rayfin up

Täysi käyttöönotto koskee rekisteröityjä kansioita, kun tallennustila on käytössä. Tarkista käyttöönoton ulostulos tallennusvaroituksien varalta ennen kansioiden käyttöä. Jos haluat yrittää uudelleen epäonnistunutta tallennusvaihetta tai soveltaa vain kansiomuutoksia olemassa olevaan käyttöön, suorita:

npx rayfin up storage apply

Sinun ei tarvitse ajaa pelkkää tallennuskomentoa onnistuneen täydellisen käyttöönoton jälkeen.

Kehitä etätallennusta vastaan

Aloita kehityssessiosi:

npx rayfin dev

Käyttämällä oletus-Fabric-palveluntarjoajaa tämä komento soveltaa käyttöön otettuja tallennusilmoituksia kehityssovellukseen Fabric-sovelluksessa. Käyttöliittymäsi toimii paikallisesti, mutta tiedostotoiminnot lukevat ja kirjoittavat etätiedostoja. Käytä kehityssovellusta ja vältä tuotantodataa testauksen aikana.

Yrittääksesi uudelleen tallennuskonfiguraatiota aktiivisen kehitysjärjestelmän käyttöönotossa, suorita:

npx rayfin dev storage apply

Aloita kokonainen rayfin dev istunto ennen kuin käytät tätä pelkkää tallennusta koskevan komennon. Uudelleentry-komento käyttää aktiivista käyttöönottoa eikä hyväksy --workspace tai --workspace-id. Docker-palveluntarjoaja ei tue tallennusta.

Asiakkaan määrittäminen

Yhdistä tallennustila sovelluksesi olemassa olevaan asiakkaaseen ja säilytä sen konfiguraatio sekä kirjautumisprosessi. Asennuskehote voi auttaa sinua konfiguroimaan asiakkaan projektiasi varten. Kirjautumis- ja tallennuskutsut käyttävät samaa asiakasistuntoa. Asiakasohjelman luominen ei kirjaudu käyttäjää sisään.

Tiedostojen käyttäminen

Seuraavissa esimerkeissä käytetään konfiguroitua, sisäänkirjautunutta client instanssia ja kansiota documents . Objektipolut ovat suhteessa kyseiseen kansioon. Käytä / polkusegmenttien välillä ja lisää tiedoston nimi lataus-, lataus- ja poistotoimintoihin. Älä käytä etu- tai jälkiviivoja /, takaviivoja, tyhjiä segmenttejä, . segmenttejä tai .. segmenttejä.

Tiedoston lataaminen palvelimeen

Välitä käyttäjän valitsema selain File :

async function uploadDocument(file: File) {
  return client.storage.documents.upload('reports/quarterly-report.pdf', file, {
    contentType: 'application/pdf',
    contentDisposition: 'attachment; filename="quarterly-report.pdf"',
  });
}

Kun lataus on valmis, käytä samaa reittiä tiedoston lataamiseen tai poistamiseen. Lataaminen samalle polulle seuraa kansion onConflict asetuksia. Valinnainen contentDisposition arvo tallentaa metatietoja, jotka kuvaavat, miten tiedosto tulisi esittää, kuten liitteen, jossa on ehdotettu tiedostonimi.

Luettelo tiedostoista

Listaa kansion juuresta tai anna hakemistopolku kaventaaksesi tuloksia:

const firstPage = await client.storage.documents.list('reports', {
  limit: 20,
});

for (const item of firstPage.items) {
  console.log(item.path, item.size);
}

if (firstPage.continuation) {
  const nextPage = await client.storage.documents.list('reports', {
    limit: 20,
    continuation: firstPage.continuation,
  });
  console.log(nextPage.items);
}

Kutsu list() ilman hakemistopolkua listaan kansion juuresta. Käytä palautettua jatkotunnusta lisäsivujen hakemiseen. Tallennusrajapinta voi sisällyttää tiedostoja tilassa Deleting listan tuloksissa. Et voi ladata tai ladata tiedostoa siinä tilassa. Jos poisto ei onnistu, yritä poistaa tiedosto uudelleen.

Lataa tiedosto

Käytä samaa suhteellista polkua, jonka annoit latauksen aikana:

const result = await client.storage.documents.download(
  'reports/quarterly-report.pdf'
);
const file = await new Response(result.stream, {
  headers: result.contentType
    ? { 'Content-Type': result.contentType }
    : undefined,
}).blob();

Hyödynnä tuloksena Blob sovelluksesi näyttö- tai latausvirta rajoitetuille tiedostoille. Tämä muunnos puskuroi koko tiedoston muistissa. Suurissa tiedostoissa kuluta result.stream sen sijaan asteittain. Jos luot objektin URL-osoitteen , URL.createObjectURLperuuta se, kun sovellus ei enää tarvitse sitä.

Tiedoston poistaminen

Poista tiedosto sen suhteellisen polun mukaan:

await client.storage.documents.delete('reports/quarterly-report.pdf');

Jos lataus- tai poisto-operaatio keskeytyy, se saattaa tilapäisesti estää toisen operaation samalla reitillä. Odota ja yritä uudelleen. Joissain tapauksissa reitti voi pysyä tukossa noin 70 minuuttia.

Muuta tai poista kansioita

Muokkaa kansion ilmoituksia projektissasi ja sovella ne tiedostolla npx rayfin up tai npx rayfin up storage apply.

Varoitus

Kansion poistaminen sovellusta asetuksista tekee siitä käyttökelvottomaksi ja poistaa tiedostot pysyvästi. Varmuuskopioi tarvittavat tiedostot ennen poiston tekemistä. Et voi palauttaa kansiota. Sen nimeä ei voi käyttää uudelleen ennen kuin poisto on valmis.

Ei-tyhjän kansion poistaminen vaatii nimenomaisen hyväksynnän seuraavasti --force:

npx rayfin up storage apply --force

Tarkista muutos ennen kuin käytät --force. Tämä vaihtoehto sallii tietojen häviön; se ei ole rutiininomainen käyttöönottolippu.

Poistamisen jälkeen kansio ei ole käytettävissä, kun tiedostot poistetaan taustalla. Jos siivous ei valmistu ja skeemassa on edelleen rekisteröityjä kansioita, suorita npx rayfin up storage apply uudelleen ja tarkista sen tulos varoitusten varalta. Jos yhtään kansiota ei ole enää rekisteröity, ota yhteyttä tukeen siivouksen saamiseksi.

Kaikkien kansio-ilmoitusten poistaminen ei poista otettuja kansioita. Älä käytä tyhjää skeemaa siivousmenetelmänä.

Monitorin tallennus

Fabric-portaalissa avaa sovelluksesi hallintanäkymä ja valitse Tallennus tarkastaaksesi sen tiedostot. Kun saatavilla, valitse Metrics, sitten valitse Tallennus nähdäksesi tallennuspyyntöjen määrän ja pyyntöjen virheprosentin.

Usein kysytyt kysymykset

Tarvitsenko erillisen Lakehouse- tai Azure-tallennus -tilin?

Nro Fabric Apps käyttää OneLake-tallennustilaa, joka on yhdistetty sovellukseesi ja työtilaasi. Sinun ei tarvitse luoda erillistä lakehouse- tai Azure-tallennus -tiliä.

Aktivoiko tallennuksen käyttöönotto sovelluksessa OneLake-vuokralaisen asetuksen?

Nro Data and Storage -toiminnon käyttöönotto määrittää sovelluksesi palvelut; se ei muuta vuokralaisten käytäntöjä. Fabric-ylläpitäjäsi täytyy varmistaa OneLake-asetus ennakkovaatimuksissa.

Tarvitsevatko sovelluksen käyttäjät erilliset OneLake-tunnukset?

Nro Kirjaa käyttäjät sovellukseesi ja käytä tallennus-SDK:ta samalla autentikoidulla asiakasistunnolla. Hallitse pääsyä kansion oikeuksilla. Anonyymi tallennustila ei ole tuettu.

Mitä minun pitäisi tarkistaa, jos en voi ladata tai ladata tiedostoja?

Varmista, että OneLake-asetus ennakkovaatimuksissa sallii tallennuksen sovelluksellesi. Varmista, että käyttäjä on kirjautuneena sisään ja hänellä on tarvittavat kansiooikeudet operaatiota varten. Tarkista Rayfinin käyttöönoton tuloste tallennusvaroituksien varalta ja tee kaikki kansion muutokset ennen uudelleenyrittämistä.

Liittyvä sisältö

  • Viimeksi päivitetty