Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: SQL Server 2016 (13.x)
SQL Server 2017 (14.x)
Dit artikel beschrijft hoe je RevoScaleR (versie 9.0.1 en later) functies kunt gebruiken om R-pakketten te installeren op SQL Server met Machine Learning Services of R Services. De RevoScaleR-functies kunnen door externe niet-beheerders worden gebruikt om pakketten op SQL Server te installeren zonder directe toegang tot de server.
RevoScaleR-functies voor pakketbeheer
De volgende tabel beschrijft de functies die worden gebruikt voor de installatie en het beheer van R-pakketten.
| Functie | Description |
|---|---|
| rxSqlLibPaths | Bepaal het pad van de instantiebibliotheek op de externe SQL Server. |
| rxFindPackage | Krijgt het pad voor één of meer pakketten op de externe SQL Server. |
| rxInstallPackages | Roep deze functie aan vanuit een externe R-client om pakketten te installeren in een SQL Server-rekencontext, hetzij vanuit een gespecificeerde repository, hetzij door lokaal opgeslagen gezipte pakketten te lezen. Deze functie controleert op afhankelijkheden en zorgt ervoor dat gerelateerde pakketten kunnen worden geïnstalleerd op SQL Server, net zoals R-pakketinstallatie in de lokale computecontext. Om deze optie te gebruiken, moet je pakketbeheer op de server en database hebben ingeschakeld. Zowel client- als serveromgevingen moeten dezelfde versie van RevoScaleR hebben. |
| rxInstalledPackages | Hiermee wordt een lijst van pakketten geïnstalleerd in de opgegeven computecontext. |
| rxSyncPackages | Kopieer informatie over een pakketbibliotheek tussen het bestandssysteem en de database, voor de opgegeven rekencontext. |
| rxRemovePackages | Verwijdert pakketten uit een gespecificeerde computecontext. Het berekent ook afhankelijkheden en zorgt ervoor dat pakketten die niet langer door andere pakketten op SQL Server worden gebruikt, worden verwijderd, om middelen vrij te maken. |
Prerequisites
Afstandbeheer ingeschakeld op SQL Server. Voor meer informatie, zie Remote R package management inschakelen op SQL Server.
De RevoScaleR-versies zijn hetzelfde op zowel client- als serveromgevingen. Zie Informatie over R-pakket ophalen voor meer informatie.
Je hebt toestemming om verbinding te maken met de server en een database, en om R-commando's uit te voeren. Je moet lid zijn van een databaserol die je toestaat pakketten te installeren op de opgegeven instantie en database.
Pakketten in gedeelde scope kunnen worden geïnstalleerd door gebruikers die tot de
rpkgs-sharedrol behoren in een gespecificeerde database. Alle gebruikers in deze rol kunnen gedeelde pakketten verwijderen.Pakketten in private scope kunnen door elke gebruiker die tot de
rpkgs-privaterol behoort in een database worden geïnstalleerd. Gebruikers kunnen echter alleen hun eigen pakketten zien en verwijderen.Database-eigenaren kunnen werken met gedeelde of private pakketten.
Clientverbindingen
Important
De ondersteuning voor Machine Learning Server (voorheen bekend als R Server) is beëindigd op 1 juli 2022. Zie Wat gebeurt er met Machine Learning Server voor meer informatie?
Een clientwerkstation kan Microsoft R-client of een Microsoft Machine Learning Server zijn (data scientists gebruiken vaak de gratis ontwikkelaarseditie) op hetzelfde netwerk.
Bij het aanroepen van pakketbeheerfuncties vanaf een externe R-client moet je eerst een compute-contextobject aanmaken met de functie RxInSqlServer . Daarna geef je voor elke pakketbeheerfunctie die je gebruikt de compute-context als argument door.
De gebruikersidentiteit wordt doorgaans gespecificeerd bij het instellen van de rekencontext. Als je bij het aanmaken van de computecontext geen gebruikersnaam en wachtwoord opgeeft, wordt de identiteit gebruikt van de gebruiker die de R-code gebruikt.
Definieer vanuit een R-commandoregel een verbindingsreeks naar de instantie en database.
Gebruik de RxInSqlServer-constructor om een SQL Server-rekencontext te definiëren, met behulp van de verbindingsreeks.
sqlcc <- RxInSqlServer(connectionString = myConnString, shareDir = sqlShareDir, wait = sqlWait, consoleOutput = sqlConsoleOutput)Maak een lijst van de pakketten die je wilt installeren en sla die op in een stringvariabele.
packageList <- c("e1071", "mice")Roep rxInstallPackages aan en geef de compute-context en de stringvariabele met de pakketnamen door.
rxInstallPackages(pkgs = packageList, verbose = TRUE, computeContext = sqlcc)Als afhankelijke pakketten nodig zijn, worden deze ook geïnstalleerd, ervan uitgaande dat er een internetverbinding beschikbaar is op de client.
Pakketten worden geïnstalleerd met behulp van de inloggegevens van de gebruiker die de verbinding maakt, in de standaardscope voor die gebruiker.
Functies voor het beheer van aanroeppakketten in opgeslagen procedures
Je kunt pakketbeheerfuncties uitvoeren binnen sp_execute_external_script. Wanneer je dit doet, wordt de functie uitgevoerd met behulp van de beveiligingscontext van de stored procedure caller.
Examples
Deze sectie geeft voorbeelden van hoe deze functies vanuit een externe client gebruikt kunnen worden bij het verbinden met een SQL Server-instantie of database als rekencontext.
Voor alle voorbeelden moet je ofwel een verbindingsreeks of een compute context opleveren, waarvoor een verbindingsreeks nodig is. Dit voorbeeld biedt een manier om een computecontext voor SQL Server te creëren:
instance_name <- "computer-name/instance-name";
database_name <- "TestDB";
sqlWait= TRUE;
sqlConsoleOutput <- TRUE;
connString <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
sqlcc <- RxInSqlServer(connectionString = connString, wait = sqlWait, consoleOutput = sqlConsoleOutput, numTasks = 4);
Afhankelijk van waar de server zich bevindt en het beveiligingsmodel, moet je mogelijk een domein- en subnetspecificatie in de verbindingsreeks opgeven, of een SQL-login gebruiken. Voorbeeld:
connStr <- "Driver=SQL Server;Server=myserver.financeweb.contoso.com;Database=Finance;Uid=RUser1;Pwd=RUserPassword"
Pakketpad ophalen in een externe SQL Server-rekencontext
Dit voorbeeld haalt het pad van het RevoScaleR-pakket op in de rekencontext, sqlcc.
sqlPackagePaths <- rxFindPackage(package = "RevoScaleR", computeContext = sqlcc)
print(sqlPackagePaths)
Results
C:/Program Files/Microsoft SQL Server/MSSQL14.MSSQLSERVER/R_SERVICES/library/RevoScaleR
Tip
Als je de optie hebt ingeschakeld om SQL console-output te zien, kun je statusberichten krijgen van de functie die aan de print instructie voorafgaat. Nadat je klaar bent met het testen van je code, zet je consoleOutput in de constructor van de computecontext op FALSE om berichten uit te schakelen.
Vind locaties voor meerdere pakketten
Het volgende voorbeeld haalt de paden op voor de pakketten RevoScaleR en lattice in de rekencontext sqlcc. Om informatie over meerdere pakketten te verkrijgen, geef je een stringvector door met de pakketnamen.
packagePaths <- rxFindPackage(package = c("RevoScaleR", "lattice"), computeContext = sqlcc)
print(packagePaths)
Haal pakketversies op in een externe rekencontext
Voer dit commando uit vanuit een R-console om het buildnummer en versienummers te krijgen voor pakketten die op de computecontext, sqlServer, zijn geïnstalleerd.
sqlPackages <- rxInstalledPackages(fields = c("Package", "Version", "Built"), computeContext = sqlServer)
Installeer een pakket op SQL Server
Dit voorbeeld installeert het forecast-pakket en de afhankelijkheden ervan in de computecontext.
pkgs <- c("forecast")
rxInstallPackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)
Verwijder een pakket uit SQL Server
Dit voorbeeld verwijdert het voorspellingspakket en zijn afhankelijkheden uit de rekencontext.
pkgs <- c("forecast")
rxRemovePackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)
Synchroniseer pakketten tussen database en bestandssysteem
Het volgende voorbeeld controleert de database TestDB en bepaalt of alle pakketten in het bestandssysteem zijn geïnstalleerd. Als sommige pakketten ontbreken, worden ze in het bestandssysteem geïnstalleerd.
# Instantiate the compute context
connectionString <- "Driver=SQL Server;Server=myServer;Database=TestDB;Trusted_Connection=True;"
computeContext <- RxInSqlServer(connectionString = connectionString )
# Synchronize the packages in the file system for all scopes and users
rxSyncPackages(computeContext=computeContext, verbose=TRUE)
Pakketsynchronisatie werkt per database en per gebruiker. Voor meer informatie, zie R-pakketsynchronisatie voor SQL Server.
Gebruik een opgeslagen procedure om pakketten te vermelden in SQL Server
Voer dit commando uit vanuit Management Studio of een andere tool die T-SQL ondersteunt, om een lijst te krijgen van geïnstalleerde pakketten op de huidige instantie, met gebruik rxInstalledPackages van een opgeslagen procedure.
EXEC sp_execute_external_script
@language=N'R',
@script=N'
myPackages <- rxInstalledPackages();
OutputDataSet <- as.data.frame(myPackages);
'
De rxSqlLibPaths functie kan worden gebruikt om de actieve bibliotheek te bepalen die door SQL Server Machine Learning Services wordt gebruikt. Dit script kan alleen het bibliotheekpad voor de huidige server teruggeven.
declare @instance_name nvarchar(100) = @@SERVERNAME, @database_name nvarchar(128) = db_name();
exec sp_execute_external_script
@language = N'R',
@script = N'
connStr <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
.libPaths(rxSqlLibPaths(connStr));
print(.libPaths());
',
@input_data_1 = N'',
@params = N'@instance_name nvarchar(100), @database_name nvarchar(128)',
@instance_name = @instance_name,
@database_name = @database_name;