Jaa


Microsoft Fabric -muistikirjojen luominen ja hallinta Visual Studio Codessa

Synapsen Visual Studio (VS) -koodilaajennus tukee täysin CruD-muistikirjatoimintoja (luo, lue, päivitä ja poista) Fabricissa. Laajennus tukee myös paikallisten ja etätyötilojen välistä synkronointia. Kun synkronoit muutokset, voit puuttua mahdollisiin ristiriitoihin tai eroihin paikallisen ja etätyötilan välillä.

Tämän laajennuksen avulla voit myös suorittaa muistikirjoja Fabricin Apache Spark -etätietokoneelle.

Avaa muistikirja, jossa on Synapse-laajennus

Napsauttamalla Fabric-portaalin muistikirjan luontisivun Avaa VS Codessa -painiketta voit avata suoraan saman muistikirjan Synapse VS Code -laajennuksella Fabricille. Kun olet aktivoinut laajennuksen VS Codessa ja avannut muistikirjan kerran, työtilasi pitäisi yhdistää automaattisesti muistikirjaan.

Näyttökuva, joka näyttää, miten voit avata muistikirjan VS Codessa.

Vihje

Jos et ole asentanut Synapse-laajennusta VS Codelle, se on asennettava ensin. Lisätietoja on kohdassa Synapse-laajennuksen asentaminen. Kun laajennus julkaistaan, asennus automatisoidaan.

Näytä muistikirjojen luettelo

Muistikirjan puusolmu sisältää kaikki nykyisen työtilan muistikirjakohteet. VS Codeen tekemiesi muutosten perusteella luettelo näyttää uusimman tilan eri väreillä ja merkeillä seuraavassa kuvassa esitetyllä tavalla.

  • Oletusarvo: Valkoinen teksti, joka ei ole muistikirjan nimen oikealla puolella, ilmaisee oletus- tai alustetun tilan. Muistikirja on olemassa etätyötilassa, eikä sitä ole ladattu paikallisesti.
  • Muokattu: Nimen oikealla puolella oleva M-merkki ja keltainen teksti osoittavat, että olet ladannut ja muokannut muistikirjaa paikallisesti VS Codessa, eikä se ole vielä julkaissut odottavia muutoksia takaisin etätyötilaan.
  • Paikallinen: L-merkki ja vihreä teksti osoittavat, että muistikirja on ladattu ja sisältö on sama kuin etätyötila.
  • Ristiriita: C-merkki ja punainen teksti osoittavat, että paikallisen version ja etätyötilaversion välillä on ristiriitoja.

Näyttökuva muistikirjaluettelosta, joka näyttää yksittäisten muistikirjojen eri tilat.

Muistikirjan luominen

  1. Pidä VS Code Explorerissa hiiren osoitinta muistikirjan työkalurivin päällä. Luo muistikirja -vaihtoehto on nyt näkyvissä.

    Näyttökuva VS Coden Muistikirja-luettelosta, joka näyttää, mistä luo muistikirja -vaihtoehto valitaan.

  2. Valitse Luo muistikirja ja kirjoita nimi ja kuvaus. Uusi muistikirja luodaan etätyötilaan, ja se näkyy muistikirjaluettelossa oletustilassa.

Lataa muistikirja

Ennen kuin voit muokata muistikirjan sisältöä, sinun on ladattava muistikirja VS Codeen.

  1. Siirrä hiivikirjaluettelossa VS Codessa muistikirjan nimen päälle. Lataa-vaihtoehto näkyy muistikirjan nimen vieressä.

    VS Code Explorer -muistikirjaluettelon näyttökuva, joka näyttää, mistä latausmuistikirja-vaihtoehto valitaan.

  2. Valitse Lataa ja tallenna muistikirja paikalliseen työhakemistoosi.

Avaa muistikirja

  1. Siirrä osoitin VS Code Explorerissa ladatun muistikirjan nimen päälle. Muistikirjan vieressä näkyy useita vaihtoehtoja, kuten Open Notebook Folder -vaihtoehto.

    VS Code Explorerin näyttökuva, jossa näkyy Avaa muistikirja -kansion valinta.

  2. Valitse Avaa muistikirjakansio , jolloin muistikirja avautuu VS Code Editor -näytössä.

Poista muistikirja

Vihje

Voit välttää epäonnistumisen sulkemalla muistikirjakansion Resurssienhallinta-näkymässä ja sulkemalla muistikirjan editorinäkymästä ennen muistikirjan poistamista.

Muistikirjan poistaminen:

  1. Pidä VS Code Explorerissa hiiren osoitinta poistettavan muistikirjan nimen päällä. nimen oikealla puolella näkyy vaihtoehtoja, mukaan lukien Poista muistikirja -vaihtoehto.

    VS Code Explorerin näyttökuva, joka näyttää Poista muistikirja -vaihtoehdon.

  2. Valitse Poista muistikirja - vaihtoehto. Kun näyttöön tulee kehote, poista vain paikallinen kopio tai sekä paikallinen että etätyötila kopioi.

Paikallisten muutosten julkaiseminen etätyötilaan

Paikallisten muutosten lähettäminen etätyötilaan:

  1. Pidä VS Code Explorerissa hiiren osoitinta sen muistikirjan nimen päällä, jonka haluat julkaista etätyötilassa. nimen oikealla puolella näkyvät asetukset, mukaan lukien Julkaise-vaihtoehto.

    VS Code Explorerin näyttökuva, joka näyttää, missä Julkaise muistikirja -vaihtoehto näkyy.

  2. Valitse Julkaise. Etätyötilan versio päivitetään paikallisen VS Coden muutoksilla.

    • Jos paikallinen päivityksesi luo yhdistämisristiriitoja, sinua pyydetään ratkaisemaan ne ennen yhdistämisen onnistumista.
  3. Jos jollain muulla on sama muistikirja auki Fabric-portaalissa, häntä ilmoitetaan paikallisen VS Code -muutoksesi hyväksymiseksi tai hylkäämiseksi seuraavassa kuvassa esitetyllä tavalla.

    Näyttökuva valintaikkunasta, joka ilmoittaa portaalin käyttäjille ulkoisen muokkauksen havaitsemisesta. Se sisältää Hyväksy- ja Hylkää-painikkeen.

    • Hyväksy: muutoksesi VS Codesta on tallennettu työtilaan.
    • Hylkää: muutoksesi VS Codesta ohitetaan.

Muutosten noutaminen etätyötilasta

Jos haluat päivittää paikalliseen versioon uusimman työtilaversion, hae etäversio:

  1. Pidä VS Code Explorerissa hiiren osoitinta päivitettävän muistikirjan nimen päällä. nimen oikealla puolella näkyvät vaihtoehdot, mukaan lukien Päivitä muistikirja -vaihtoehto.

    VS Code Explorerin näyttökuva, jossa näkyy **Päivitä muistikirja** -vaihtoehto.

  2. Valitse Päivitä muistikirja - vaihtoehto. VS Code hakee uusimman version etätyötilasta ja avaa VS Code diff -editorin, jotta voit verrata kahta muistikirjatiedostoa. Vasen näyttö on työtilasta ja oikea näyttö on paikallisesta versiosta:

    Näyttökuva, jossa näkyy päivitysmuistikirjan eronäyttö.

  3. Päivitä vasemmalla puolella oleva koodi/markdown-solu ongelman korjaamiseksi.

  4. Kun olet ratkonut kaikki ristiriidat, valitse Yhdistä-vaihtoehto eroeditorin oikeasta yläkulmasta ja varmista, että yhdistäminen on valmis. (Kunnes valitset Yhdistä, muistikirja pysyy ristiriitatilassa .)

    Näyttökuva VS Coden eroeditori-näytön oikeasta yläkulmasta, josta näkyy, mistä valitset Yhdistä-vaihtoehdon.

Tärkeä

Kun olet avannut eroeditorin kerran, laajennus EI päivitä automaattisesti eronäkymän vasenta puolta, jotta etätyötilasta voidaan noutaa uusin päivitys.

Suorita muistikirja tai korjaa muistikirja spark-etätietokonetta varten

Valitsemalla tämän laajennuksen mukana toimitetun kernel synapse-spark-kernel-ytimen voit suorittaa koodisolun etäsynkronin käsittelytoiminnon päälle. Kun tämä ydin on valittu, laajennus siepataan suorituksen aikana kaikki PySpark-ohjelmointirajapinnan kutsut ja kääntää ne vastaavaksi http-kutsuksi etäsynnyttelylle. Jos kyseessä on puhdas Python-koodi, se suoritetaan silti paikallisessa ympäristössä.

Näyttökuva, jossa näkyy muistikirjan suorituspaikka.