Skip to content

Commit 47c8184

Browse files
rwestMSFTrwestMSFT
committed
Refresh some filestream articles relating to PR 9353
1 parent 94d3250 commit 47c8184

3 files changed

Lines changed: 164 additions & 157 deletions

File tree

‎docs/database-engine/configure-windows/server-properties-filestream-page.md‎

Lines changed: 42 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,42 @@
1-
---
2-
title: "SQL Server Properties (FILESTREAM Page)"
3-
description: Get acquainted with FILESTREAM settings in SQL Server. Learn how to turn on FILESTREAM, and see how to configure remote client access and other properties.
4-
author: rwestMSFT
5-
ms.author: randolphwest
6-
ms.date: "03/14/2017"
7-
ms.service: sql
8-
ms.subservice: configuration
9-
ms.topic: conceptual
10-
f1_keywords:
11-
- "sql13.swb.serverproperties.filestream.f1"
12-
helpviewer_keywords:
13-
- "FILESTREAM [SQL Server], properties page"
14-
---
15-
# Server Properties - FILESTREAM Page
16-
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
17-
Use this page to enable FILESTREAM for this installation of [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)].
18-
19-
## UI element list
20-
**Enable FILESTREAM for Transact-SQL access**
21-
Select to enable FILESTREAM for [!INCLUDE[tsql](../../includes/tsql-md.md)] access. This control must be checked before the other control options will be available.
22-
23-
**Enable FILESTREAM for file I/O streaming access**
24-
Select to enable Win32 streaming access for FILESTREAM.
25-
26-
**Windows share name**
27-
Use this control to enter the name of the Windows share in which the FILESTREAM data will be stored.
28-
29-
**Allow remote clients to have streaming access to FILESTREAM data**
30-
Select this control to allow remote clients to access this FILESTREAM data on this server.
31-
32-
## See Also
33-
[FILESTREAM (SQL Server)](../../relational-databases/blob/filestream-sql-server.md)
34-
[sp_configure (Transact-SQL)](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md)
35-
36-
1+
---
2+
title: "SQL Server Properties (FILESTREAM Page)"
3+
description: Get acquainted with FILESTREAM settings in SQL Server. Learn how to turn on FILESTREAM, and see how to configure remote client access and other properties.
4+
author: rwestMSFT
5+
ms.author: randolphwest
6+
ms.date: 09/28/2023
7+
ms.service: sql
8+
ms.subservice: configuration
9+
ms.topic: conceptual
10+
f1_keywords:
11+
- "sql13.swb.serverproperties.filestream.f1"
12+
helpviewer_keywords:
13+
- "FILESTREAM [SQL Server], properties page"
14+
---
15+
# Server Properties - FILESTREAM Page
16+
17+
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
18+
19+
Use this page to enable FILESTREAM for this installation of [!INCLUDE [ssnoversion](../../includes/ssnoversion-md.md)].
20+
21+
## UI element list
22+
23+
- **Enable FILESTREAM for Transact-SQL access**
24+
25+
Select to enable FILESTREAM for [!INCLUDE [tsql](../../includes/tsql-md.md)] access. This control must be checked before the other control options will be available.
26+
27+
- **Enable FILESTREAM for file I/O streaming access**
28+
29+
Select to enable Win32 streaming access for FILESTREAM.
30+
31+
- **Windows share name**
32+
33+
Use this control to enter the name of the Windows share in which the FILESTREAM data will be stored.
34+
35+
- **Allow remote clients to have streaming access to FILESTREAM data**
36+
37+
Select this control to allow remote clients to access this FILESTREAM data on this server.
38+
39+
## Related content
40+
41+
- [FILESTREAM (SQL Server)](../../relational-databases/blob/filestream-sql-server.md)
42+
- [sp_configure (Transact-SQL)](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md)

‎docs/relational-databases/blob/enable-and-configure-filestream.md‎

Lines changed: 75 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ title: "Enable and configure FILESTREAM"
33
description: To use FILESTREAM, first enable it on the SQL Server Database Engine instance. Learn how to enable FILESTREAM by using SQL Server Configuration Manager.
44
author: MikeRayMSFT
55
ms.author: mikeray
6-
ms.date: "08/23/2017"
6+
ms.reviewer: randolphwest
7+
ms.date: 09/28/2023
78
ms.service: sql
89
ms.subservice: filestream
910
ms.topic: conceptual
@@ -12,75 +13,76 @@ helpviewer_keywords:
1213
---
1314
# Enable and configure FILESTREAM
1415

15-
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
16-
Before you can start to use FILESTREAM, you must enable FILESTREAM on the instance of the [!INCLUDE[ssDEnoversion](../../includes/ssdenoversion-md.md)]. This topic describes how to enable FILESTREAM by using SQL Server Configuration Manager.
17-
18-
## <a name="enabling"></a> Enabling FILESTREAM
19-
20-
#### To enable and change FILESTREAM settings
21-
22-
1. On the **Start** menu, point to **All Programs**, point to [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)], point to **Configuration Tools**, and then click **SQL Server Configuration Manager**.
23-
24-
2. In the list of services, right-click **SQL Server Services**, and then click **Open**.
25-
26-
3. In the **SQL Server Configuration Manager** snap-in, locate the instance of [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] on which you want to enable FILESTREAM.
27-
28-
4. Right-click the instance, and then click **Properties**.
29-
30-
5. In the **SQL Server Properties** dialog box, click the **FILESTREAM** tab.
31-
32-
6. Select the **Enable FILESTREAM for Transact-SQL access** check box.
33-
34-
7. If you want to read and write FILESTREAM data from Windows, click **Enable FILESTREAM for file I/O streaming access**. Enter the name of the Windows share in the **Windows Share Name** box.
35-
36-
8. If remote clients must access the FILESTREAM data that is stored on this share, select **Allow remote clients to have streaming access to FILESTREAM data**.
37-
38-
9. Click **Apply**.
39-
40-
10. In [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)], click **New Query** to display the Query Editor.
41-
42-
11. In Query Editor, enter the following [!INCLUDE[tsql](../../includes/tsql-md.md)] code:
43-
44-
```sql
45-
EXEC sp_configure filestream_access_level, 2
46-
RECONFIGURE
47-
```
48-
49-
12. Click **Execute**.
50-
51-
13. Restart the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] service.
52-
53-
## <a name="best"></a> Best practices
54-
55-
### <a name="config"></a> Physical configuration and maintenance
56-
When you set up FILESTREAM storage volumes, consider the following guidelines:
57-
58-
- Turn off short file names on FILESTREAM computer systems. Short file names take significantly longer to create. To disable short file names, use the Windows **fsutil** utility.
59-
60-
- Regularly defragment FILESTREAM computer systems.
61-
62-
- Use 64-KB NTFS clusters. Compressed volumes must be set to 4-KB NTFS clusters.
63-
64-
- Disable indexing on FILESTREAM volumes and set **disablelastaccess**. To set **disablelastaccess**, use the Windows **fsutil** utility.
65-
66-
- Disable antivirus scanning of FILESTREAM volumes when it is not necessary. If antivirus scanning is necessary, avoid setting policies that will automatically delete offending files.
67-
68-
- Set up and tune the RAID level for fault tolerance and the performance that is required by an application.
69-
70-
|RAID level|Write performance|Read performance|Fault tolerance|Remarks|
71-
|-|-|-|-|-|
72-
|RAID 5|Normal|Normal|Excellent|Performance is better than one disk or JBOD; and less than RAID 0 or RAID 5 with striping.|
73-
|RAID 0|Excellent|Excellent|None||
74-
|RAID 5 + striping|Excellent|Excellent|Excellent|Most expensive option.|
75-
76-
77-
### <a name="database"></a> Physical database design
78-
When you design a FILESTREAM database, consider the following guidelines:
79-
80-
- FILESTREAM columns must be accompanied by a corresponding **uniqueidentifier**ROWGUID column. These kinds of tables must also be accompanied by a unique index. Typically this index is not a clustered index. If the databases business logic requires a clustered index, you have to make sure that the values stored in the index are not random. Random values will cause the index to be reordered every time that a row is added or removed from the table.
81-
82-
- For performance reasons, FILESTREAM filegroups and containers should reside on volumes other than the operating system, [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] database, [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] log, tempdb, or paging file.
83-
84-
- Space management and policies are not directly supported by FILESTREAM. However, you can manage space and apply policies indirectly by assigning each FILESTREAM filegroup to a separate volume and using the volume's management features.
85-
86-
16+
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
17+
18+
Before you can start to use FILESTREAM, you must enable FILESTREAM on the instance of the [!INCLUDE [ssDEnoversion](../../includes/ssdenoversion-md.md)]. This topic describes how to enable FILESTREAM by using SQL Server Configuration Manager.
19+
20+
## <a id="enabling"></a> Enable FILESTREAM
21+
22+
1. On the **Start** menu, navigate to **All Programs > [!INCLUDE [ssnoversion](../../includes/ssnoversion-md.md)] > Configuration Tools**, and then select **SQL Server Configuration Manager**.
23+
24+
> [!NOTE]
25+
> On newer versions of Windows, follow these instructions to [open SQL Server Configuration Manager](../sql-server-configuration-manager.md).
26+
27+
1. In the list of services, right-click **SQL Server Services**, and then select **Open**.
28+
29+
1. In the **SQL Server Configuration Manager** snap-in, locate the instance of [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] on which you want to enable FILESTREAM.
30+
31+
1. Right-click the instance, and then select **Properties**.
32+
33+
1. In the **SQL Server Properties** dialog box, select the **FILESTREAM** tab.
34+
35+
1. Select the **Enable FILESTREAM for Transact-SQL access** check box.
36+
37+
1. If you want to read and write FILESTREAM data from Windows, select **Enable FILESTREAM for file I/O streaming access**. Enter the name of the Windows share in the **Windows Share Name** box.
38+
39+
1. If remote clients must access the FILESTREAM data that is stored on this share, select **Allow remote clients to have streaming access to FILESTREAM data**.
40+
41+
1. Select **Apply**.
42+
43+
1. In [!INCLUDE [ssManStudioFull](../../includes/ssmanstudiofull-md.md)], select **New Query** to display the Query Editor.
44+
45+
1. In Query Editor, enter the following [!INCLUDE [tsql](../../includes/tsql-md.md)] code:
46+
47+
```sql
48+
EXEC sp_configure filestream_access_level, 2;
49+
RECONFIGURE;
50+
```
51+
52+
1. Select **Execute**.
53+
54+
1. Restart the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] service.
55+
56+
## <a id="best"></a> Best practices
57+
58+
### <a id="config"></a> Physical configuration and maintenance
59+
60+
When you set up FILESTREAM storage volumes, consider the following guidelines:
61+
62+
- Turn off short file names on FILESTREAM computer systems. Short file names take significantly longer to create. To disable short file names, use the Windows **fsutil** utility.
63+
64+
- Regularly defragment FILESTREAM computer systems using magnetic storage.
65+
66+
- Use 64-KB NTFS clusters. Compressed volumes must be set to 4-KB NTFS clusters.
67+
68+
- Disable indexing on FILESTREAM volumes and set `disablelastaccess`. To set `disablelastaccess`, use the Windows **fsutil** utility.
69+
70+
- Disable antivirus scanning of FILESTREAM volumes when it's not necessary. If antivirus scanning is necessary, avoid setting policies that will automatically delete offending files.
71+
72+
- Set up and tune the RAID level for fault tolerance and the performance that is required by an application.
73+
74+
| RAID level | Write performance | Read performance | Fault tolerance | Remarks |
75+
| --- | --- | --- | --- | --- |
76+
| RAID 5 | Normal | Normal | Excellent | Performance is better than one disk or JBOD; and less than RAID 0 or RAID 5 with striping. |
77+
| RAID 0 | Excellent | Excellent | None | |
78+
| RAID 5 + striping | Excellent | Excellent | Excellent | Most expensive option. |
79+
80+
### <a id="database"></a> Physical database design
81+
82+
When you design a FILESTREAM database, consider the following guidelines:
83+
84+
- FILESTREAM columns must be accompanied by a corresponding **uniqueidentifier** ROWGUID column. These kinds of tables must also be accompanied by a unique index. Typically this index isn't a clustered index. If the databases business logic requires a clustered index, you have to make sure that the values stored in the index aren't random. Random values will cause the index to be reordered every time that a row is added or removed from the table.
85+
86+
- For performance reasons, FILESTREAM filegroups and containers should reside on volumes other than the operating system, [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] database, [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] log, `tempdb`, or paging file.
87+
88+
- Space management and policies aren't directly supported by FILESTREAM. However, you can manage space and apply policies indirectly by assigning each FILESTREAM filegroup to a separate volume and using the volume's management features.

0 commit comments

Comments
 (0)