Habilitar os pré-requisitos para FileTable

Artigo
06/14/2017

Descreve como habilitar os pré-requisitos para criar e usar FileTables.

Habilitando os pré-requisitos para FileTable

Para habilitar os pré-requisitos para criar e usar FileTables, habilite os seguintes itens:

No nível de instância:
- Habilitando o FILESTREAM no nível de instância
No nível de banco de dados:

Habilitando o FILESTREAM no nível de instância

FileTables estendem os recursos do recurso FILESTREAM de SQL Server. Portanto, você precisa habilitar FILESTREAM para acesso de E/S de arquivo no nível do Windows e na instância do SQL Server antes de criar e usar FileTables.

Como habilitar o FILESTREAM no nível de instância

Para obter informações sobre como habilitar o FILESTREAM, veja Habilitar e configurar o FILESTREAM.

Quando você chama o sp_configure para habilitar o FILESTREAM no nível de instância, precisa definir a opção filestream_access_level como 2. Para obter mais informações, veja Opção filestream access level de configuração de servidor.

Como permitir o FILESTREAM através do Firewall

Para obter informações sobre como permitir o FILESTREAM através do firewall, consulte Configure a Firewall for FILESTREAM Access.

Fornecendo um grupo de arquivos FILESTREAM no nível de banco de dados

Antes de você poder criar FileTables em um banco de dados, o banco de dados deve ter um grupo de arquivos FILESTREAM. Para obter mais informações sobre esses pré-requisitos, veja Criar um banco de dados habilitado para FILESTREAM.

Habilitando o acesso não transacional em nível de banco de dados

As FileTables permitem que os aplicativos do Windows obtenham um identificador de arquivo do Windows para dados de FILESTREAM sem precisar de uma transação. Para permitir esse acesso não transacional aos arquivos armazenados em SQL Server, você precisa especificar o nível desejado de acesso não transacional no nível do banco de dados para cada banco de dados que conterá FileTables.

Como verificar se o acesso não transacional está habilitado em bancos de dados

Consulte o sys.database_filestream_options de exibição de catálogo (Transact-SQL) e marcar as colunas non_transacted_access e non_transacted_access_desc.

SELECT DB_NAME(database_id), non_transacted_access, non_transacted_access_desc  
    FROM sys.database_filestream_options;  
GO

Como habilitar o acesso não transacional no nível de banco de dados

Os níveis disponíveis de acesso não transacional são FULL, READ_ONLY e OFF.

Especificar o nível de acesso não transacional usando Transact-SQL

Ao criar um novo banco de dados, chame a instrução CREATE DATABASE (SQL Server Transact-SQL) com a opção NON_TRANSACTED_ACCESS FILESTREAM.

```sql  
CREATE DATABASE database_name  
    WITH FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'directory_name' )  
```

Ao alterar um banco de dados existente, chame a instrução ALTER DATABASE (Transact-SQL) com a opção NON_TRANSACTED_ACCESS FILESTREAM.
```
ALTER DATABASE database_name  
    SET FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'directory_name' )  
```

Especificar o nível de acesso não transacional usando o SQL Server Management Studio
Você pode especificar o nível de acesso não transacional no campo Acesso Não Transacionado a FILESTREAM da página Opções da caixa de diálogo Propriedades do Banco de dados . Para obter mais informações sobre essa caixa de diálogo, consulte Propriedades do banco de dados (página Opções).

Especificando um diretório para FileTables no nível de banco de dados

Quando você habilita o acesso não transacional a arquivos no nível de banco de dados, tem como opção fornecer um nome de diretório ao mesmo tempo usando a opção DIRECTORY_NAME . Se você não fornecer um nome de diretório ao habilitar o acesso não transacional, deverá fornecê-lo posteriormente para que possa criar FileTables no banco de dados.

Na hierarquia de pastas de FileTable, esse diretório em nível de banco de dados se torna o filho do nome de compartilhamento especificado para FILESTREAM no nível de instância, e o pai das FileTables criadas no banco de dados. Para obter mais informações, consulte Work with Directories and Paths in FileTables.

Como especificar um diretório para FileTables no nível de banco de dados

O nome que você especifica deve estar exclusivo na instância para diretórios em nível de banco de dados.

Especificar um diretório para FileTables usando Transact-SQL

Ao criar um novo banco de dados, chame a instrução CREATE DATABASE (SQL Server Transact-SQL) com a opção DIRECTORY_NAME FILESTREAM.

```sql  
CREATE DATABASE database_name  
    WITH FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'directory_name' );  
GO  
```

Ao alterar um banco de dados existente, chame a instrução ALTER DATABASE (Transact-SQL) com a opção DIRECTORY_NAME FILESTREAM. Quando você usa estas opções para alterar o nome do diretório, o banco de dados deve ser bloqueado de forma exclusiva, sem identificadores de arquivos abertos.
```
ALTER DATABASE database_name  
    SET FILESTREAM ( NON_TRANSACTED_ACCESS = FULL, DIRECTORY_NAME = N'directory_name' );  
GO  
```
Ao anexar um banco de dados, chame a instrução CREATE DATABASE (SQL Server Transact-SQL) com a opção FOR ATTACH e com a opção DIRECTORY_NAME FILESTREAM.
```
CREATE DATABASE database_name  
    FOR ATTACH WITH FILESTREAM ( DIRECTORY_NAME = N'directory_name' );  
GO  
```
Ao restaurar um banco de dados, chame a instrução RESTORE (Transact-SQL) com a opção DIRECTORY_NAME FILESTREAM.
```
RESTORE DATABASE database_name  
    WITH FILESTREAM ( DIRECTORY_NAME = N'directory_name' );  
GO  
```

Especificar um diretório para FileTables usando o SQL Server Management Studio
Você pode especificar um nome de diretório no campo Nome do Diretório FILESTREAM da página Opções da caixa de diálogo Propriedades do Banco de dados . Para obter mais informações sobre essa caixa de diálogo, consulte Propriedades do banco de dados (página Opções).

Como exibir nomes de diretórios existentes para a instância

Para exibir a lista de nomes de diretório existentes para a instância, consulte a exibição de catálogo sys.database_filestream_options (Transact-SQL) e marcar a coluna filestream_database_directory_name.

SELECT DB_NAME ( database_id ), directory_name  
    FROM sys.database_filestream_options;  
GO

Requisitos e restrições para o diretório em nível de banco de dados

Definir DIRECTORY_NAME é opcional quando você chama CREATE DATABASE ou ALTER DATABASE. Se você não especificar um valor para DIRECTORY_NAME, o nome de diretório permanecerá nulo. Entretanto, você só poderá criar FileTables no banco de dados quando especificar um valor para DIRECTORY_NAME no nível de banco de dados.
O nome de diretório que você fornece deve atender aos requisitos do sistema de arquivos para um nome de diretório válido.
Quando o banco de dados contém FileTables, não é possível definir DIRECTORY_NAME como um valor nulo.
Quando você anexar ou restaurar um banco de dados, a operação falhará se o novo banco de dados tiver um valor para DIRECTORY_NAME já existente na instância de destino. Especifique um valor exclusivo para DIRECTORY_NAME quando chamar CREATE DATABASE FOR ATTACH ou RESTORE DATABASE.
Quando você atualiza um banco de dados existente para SQL Server 2014, o valor de DIRECTORY_NAME é nulo.
Quando você habilita ou desabilita o acesso não transacional no nível de banco de dados, a operação não verifica se o nome de diretório foi especificado ou se é exclusivo.
Quando você remove um banco de dados que foi habilitado para FileTables, o diretório no nível de banco de dados e todas as estruturas de diretórios de todos os FileTables contidos nele serão removidos.

Partilhar via